Carts

Release a cart

Releases this cart and nothing else. A build grant may release only a cart its own application built. A cart still building is accepted with 202 canceling: Layout records the cancel, releases the cart the moment the build lands, and never texts the person that it is ready; read it until it is canceled. A cart already confirmed is not canceled here: the answer is cart_closed with error.order naming the order and its state now.

post/carts/{cartId}/cancel

Request

  • Base URL: https://api.layout.link/v1
  • URL: https://api.layout.link/v1/carts/{cartId}/cancel
  • Auth: HTTP bearer

Path parameters

cartIdstring required

The crt_ id.

Headers

Layout-Version'2026-10-01'

The API version you code against. Optional; without it you get 2026-10-01, the current version. Layout answers with the version it used.

Idempotency-Keystring

Optional. Any 1 to 255 visible ASCII characters, unique per real intent. A retry with the same key and the same body gets the stored response for 24 hours, with Idempotent-Replayed: true, and is never run twice. The same key with a different body is 409 idempotency_conflict; while the first request is still running it is 409 in_progress with Retry-After. Only a success is stored: any error releases the key so it can be sent again. A 4xx ran nothing. A 5xx may have run, above all a confirm's 500, so read the resource before sending anything changed.

Response

Released: canceled.

Changes

No recorded changes to this operation across all 1 revision of this API.