Delete a showcase
/showcases/{showcase_id}Moves the showcase to the trash. Its child showcases, the products in the showcase, and its copies in replicated accounts are moved to the trash along with it.
Replicated showcases are read-only and cannot be deleted. Attempts to delete them return the replica_readonly error code.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Header Parameters
Client-generated key that makes the request safe to retry. Must be 1 to 128 characters from [A-Za-z0-9._:-]. Optional on this operation; when sent, a malformed key returns idempotency_key_invalid, and repeating the request with the same key and the same body returns the stored result with Idempotent-Replayed: true.
Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.
length <= 64Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/showcases/string"Update a showcase PATCH
Updates an existing showcase. Only the fields present in the request are changed. Updating `status` requires the `showcases.publish` permission in addition to `showcases.update`. Setting `parent_id` moves the showcase into a group, or to the top level when `null`; moves that would break the two-level hierarchy are rejected with `hierarchy_violation`. Setting `deleted` to `false` restores a showcase from the trash. `position` is 1-based within the showcase's level, in the new level when `parent_id` changes; a value greater than the number of showcases at that level places the showcase at the end. A showcase moved to another level without `position` is placed at the end. Replicated showcases accept only `status`; a request that includes any other field returns the `replica_readonly` error code. Send the current `ETag` value in the `If-Match` header to avoid overwriting changes made since the showcase was retrieved.
Duplicate a showcase POST
Creates a copy of the showcase in the same account. Copying a showcase to a different account is not supported.