API ReferenceStorefront

Update a bundle

PATCH /rest/v1/storefront/bundles/{id}

PATCH
/storefront/bundles/{id}

Changes only the fields sent; items replaces the whole list. Same checks as create. Required scope: storefront:write.

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Unique client-generated key (max 255 chars), stored 24h.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X PATCH "https://example.com/storefront/bundles/bndl_q83pgewu" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "bndl_q83pgewu",  "object": "bundle",  "name": "string",  "description": "string",  "image": "string",  "pricing": {    "type": "percentage",    "value": 10  },  "items": [    {      "product_id": "string",      "variant_id": "string",      "quantity": 0    }  ],  "active": true,  "simulated": true}

Last updated on October 18, 2026

Need help?

Email us and a human replies, usually within one business day.