For the complete documentation index, see llms.txt. This page is also available as Markdown.

Partially update a bundle chapter

Updates one or more fields of an existing bundle chapter. Only the fields you send are changed — but sending bundle_product, attribute_set, attributes, or attributes_kwargs has no effect regardless; see the full update for details. default_product, when sent, must reference a Miscellaneous (4) product and can only be set or replaced, not cleared.

patch
/bundle_chapters/{id}/
Authorizations
AuthorizationstringRequired

Token credential sent in the Authorization header, in the form: Token <your-token>. Requires a staff (admin) account.

Path parameters
idintegerRequired

The unique identifier of the bundle chapter.

Body

The data used to partially update a bundle chapter. Only the fields you send are changed, except bundle_product, attribute_set, attributes, and attributes_kwargs, which are accepted but ignored — see the Validation Rules in the Bundle Chapters section.

namestring · max: 255Optional

The chapter's display name.

slugstring · max: 128Optional

The chapter's identifier within its bundle product. Must be unique per bundle_product.

bundle_productintegerOptional

Not applied on update — a chapter cannot be moved to a different bundle product.

default_productinteger · nullableOptional

The identifier of the miscellaneous product to pre-select for this chapter. Must reference a product whose product_type is Miscellaneous (4). Can be used to set or replace the default product, but not to clear it — sending null has no effect if one is already set.

attribute_setintegerOptional

Not applied on update.

orderintegerOptional

The chapter's position among its bundle product's chapters.

is_activebooleanOptional

Whether the chapter is active.

is_requiredbooleanOptional

Whether the customer must make a selection for this chapter.

is_form_requiredbooleanOptional

Whether this chapter renders a form requiring additional input, rather than a plain selection.

Responses
200

The updated bundle chapter.

application/json

A configurable selection chapter of a bundle product.

pkintegerRead-onlyOptional

The unique identifier of the bundle chapter.

namestring · max: 255Optional

The chapter's display name.

slugstring · max: 128Optional

The chapter's identifier within its bundle product. Must be unique per bundle_product.

bundle_productintegerOptional

The identifier of the parent product. Must reference a product whose product_type is Bundle (2). Fixed at creation — a chapter's bundle product cannot be changed afterwards.

default_productinteger · nullableOptional

The identifier of the miscellaneous product pre-selected for this chapter, when set. Must reference a product whose product_type is Miscellaneous (4). Can be set or replaced through an update, but not cleared back to null once set.

attribute_setintegerOptional

The identifier of the attribute set that defines this chapter's selectable attributes. Can only be set at creation — sending a different value on update has no effect.

orderintegerOptional

The chapter's position among its bundle product's chapters. Chapters are listed ordered by this value by default.

Default: 0
is_activebooleanOptional

Whether the chapter is active.

Default: true
is_requiredbooleanOptional

Whether the customer must make a selection for this chapter.

Default: true
is_form_requiredbooleanOptional

Whether this chapter renders a form requiring additional input, rather than a plain selection.

Default: false
patch/bundle_chapters/{id}/
PATCH /api/v1/remote/1/bundle_chapters/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 270

{
  "name": "text",
  "slug": "text",
  "bundle_product": 1,
  "default_product": null,
  "attribute_set": 1,
  "order": 1,
  "is_active": true,
  "is_required": true,
  "is_form_required": true,
  "attributes": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "attributes_kwargs": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}
{
  "pk": 1,
  "name": "text",
  "slug": "text",
  "bundle_product": 1,
  "default_product": null,
  "attribute_set": 1,
  "order": 0,
  "is_active": true,
  "is_required": true,
  "is_form_required": false,
  "attributes": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "attributes_kwargs": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "attr_key": [
    {
      "pk": 42,
      "key": "color",
      "name": "Color",
      "data_type": "dropdown",
      "default_value": null,
      "is_required": true,
      "is_visible": true,
      "is_searchable": true,
      "is_filterable": true,
      "is_variant": true,
      "is_variant_listable": true,
      "is_form_required": false,
      "is_form_field_required": false
    }
  ]
}

Last updated

Was this helpful?