Carts

Answer a cart's question

Builds the cart again with the person's answer. The answer is a new cart: poll the id this returns.

post/carts/{cartId}/answer

Request

  • Base URL: https://api.layout.link/v1
  • URL: https://api.layout.link/v1/carts/{cartId}/answer
  • 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.

Request body

choicesstring

The person's answer to a choices decision, in their words.

acceptPickupTimetrue

The person accepts the pickup time a pickup_time decision states.

idempotencyKeystring

Unique per real intent. A retry with the same key and body returns the same answer. Optional when the request carries an Idempotency-Key header, whose value is then used; when both are sent, this one names the cart or the confirm.

Response

The new build started.

Changes

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