Take a layer off a brand
remove_brand_layerRemove a composed brand layer by permanent record ID while keeping the design kit and other axes. Confirmation is required to make the deletion permanent.
Instructions
Remove one composed record from a brand project. The brand keeps its design kit and every other axis; only this reference goes. Name the record rather than just the axis, so a stale view of the brand cannot clear a layer it never saw — pass the id you read from get_brand_layers rather than one you remember. Safe to repeat: an id that is not composed answers changed: false, changes nothing and mints no version. When the intent is to swap rather than to clear, call add_brand_layer with replace: true instead; removing first leaves the brand briefly without that axis and takes two versions to say one thing. This takes effect on the user's brand immediately and requires confirm: true; without it nothing changes. Requires the kits:write scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| axis | Yes | Which axis the record sits on. | |
| confirm | Yes | Must be exactly true. Required because removal is permanent. | |
| recordId | Yes | Permanent id of the composed record, as reported by get_brand_layers. | |
| projectId | Yes | Owned brand project id from list_brand_projects. |