deleteQuote

Live

Delete a draft quote (soft delete)

Delete a draft quote (soft delete; history is kept). Owner and admin. QUOTE_NOT_EDITABLE once it is sent or converted: make a new quote instead. QUOTE_NOT_FOUND for an unknown id.

POST/graphqlapp audience

Who can call this. Owner, admin.

Headers

Required Optional

AuthorizationstringRequired
Bearer <token>, issued for this endpoint's audience. The token decides the shop and roles; nothing in the request body can change them.
Example: Bearer eyJhbGciOiJFZERTQSJ9…
Content-TypestringRequired
Always application/json. Only POST is accepted.
Example: application/json
Idempotency-KeystringRequired
A key you generate once per user action (a UUID). Retrying with the same key never applies the change twice.
Example: 0192f0c1-9b2a-7d40-8c3e-1f5a6b7c8d9e
X-Request-IdstringOptional
Your id for this request (8–128 characters of A–Z a–z 0–9 . _ : -). Echoed back in the response header and in every error, so you can quote it when reporting a problem. Core makes one if you send none.
Example: app-7f3c2a9e-checkout

Arguments

Required Optional

idID!Required
The quote id.
Example: "0192f0c1-0000-7000-8000-000000b00006"

Returns

Required Optional

deleteQuoteBoolean!Required
Delete a draft quote (soft delete; history is kept). Owner and admin. QUOTE_NOT_EDITABLE once it is sent or converted: make a new quote instead. QUOTE_NOT_FOUND for an unknown id.

Errors

Code	HTTP	When
`QUOTE_NOT_EDITABLE`	`409`	updateQuote on a quote that is already sent or has become an order.
`QUOTE_NOT_FOUND`	`404`	The id is unknown in this shop (another shop's quote answers the same).

Every error has the same body. See Errors.

Rate limit tier

Tier: per user. Over the limit you get RATE_LIMITED (HTTP 429) with a Retry-After header. See Response handling.