AI sign designs
Delete a failed quote file conversion
Deletes a failed AI design made from a quote file, so that the file can
be converted again, as the merchant admin's Quotes page does. Requires
ai_sign_designs:write and quotes:read, and an Idempotency-Key.
Overview
Only a design of the quote's files can be deleted: another store's
quote or design, a design of another quote and an unknown id answer the
same 404.
A design can be deleted only when its status is failed and no work
on it is still running; a credit hold it still has is released first.
Otherwise this answers 409
ai_design_not_deletable and nothing changes: read the design and try
again later with a new key. The response is the design as it was. A
retry with the same request and key replays that answer. The private
copy of the quote file is deleted with the design; the quote and its
file are not changed. Each key may delete 10 designs a minute.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: ai_sign_designs:write
Path parameters
The submission id, from the list quotes operation.
Example: 8123
The AI design id, from the list the AI designs of a quote operation.
Example: 51234
curl https://web.signcustomiser.com/api/v3/quotes/8123/ai-designs/51234 \
--request DELETE \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'{
"data": {
"object": "ai_design",
"id": 51234,
"origin": "quote",
"status": "failed",
"product_family": "neon",
"customiser_id": 42,
"files": [
{
"kind": "source",
"purpose": "source",
"media_type": "image/png",
"access": "private",
"url": "https://web.signcustomiser.com/api/v3/ai-designs/51234/files/source",
"download_url": null
}
],
"product_ids": [],
"order_ids": [],
"quote_id": 8123,
"quote_file": {
"field_id": "field_artwork",
"file_index": 0
},
"ai_sign_design_job_id": null,
"feedback_rating": null,
"created_at": "2026-10-20T09:32:00Z"
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/quotes/8123/ai-designs/51234",
"documentation": "https://www.signcustomiser.com/help/api/"
},
"meta": {
"api_version": "v3",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_idempotency_key",
"title": "Missing idempotency key",
"status": 400,
"code": "missing_idempotency_key",
"detail": "Provide an Idempotency-Key header for this write.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
"title": "Missing API key",
"status": 401,
"code": "missing_api_key",
"detail": "Provide a store API key as a bearer token.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This operation requires the ai_sign_designs:write scope.",
"required_scopes": [
"ai_sign_designs:write"
],
"granted_scopes": [
"ai_sign_designs:read"
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
"title": "Resource not found",
"status": 404,
"code": "resource_not_found",
"detail": "The requested resource does not exist or does not belong to the authenticated store.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/ai_design_not_deletable",
"title": "AI design not deletable",
"status": 409,
"code": "ai_design_not_deletable",
"detail": "Only a failed design with no work still running can be deleted, so that its quote file can be converted again. This design is still processing, was delivered, or still has work running. Nothing was deleted. Read the design, and retry with a new Idempotency-Key when status is failed.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/unknown_parameter",
"title": "Unknown query parameter",
"status": 422,
"code": "unknown_parameter",
"detail": "This endpoint accepts no query parameters.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"detail": "You have exceeded the request limit for this API key.",
"retry_after": 60,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}