# DELETE 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`. 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.

- Source URL: https://www.signcustomiser.com/help/api/v3-delete-delete-a-failed-quote-file-conversion/
- Markdown URL: https://www.signcustomiser.com/help/api/v3-delete-delete-a-failed-quote-file-conversion.md
- Group: AI sign designs
- OpenAPI for this group: https://www.signcustomiser.com/help/openapi/ai-sign-designs.json
- Method: DELETE
- Path: /api/v3/quotes/{quote_id}/ai-designs/{ai_design_id}
- Auth: Bearer token
- Required scopes: `ai_sign_designs:write`

## Path parameters

- quote_id (string, required): The submission id, from the list quotes operation. Example: 8123
- ai_design_id (string, required): The AI design id, from the list the AI designs of a quote operation. Example: 51234

## cURL example

```bash
curl https://web.signcustomiser.com/api/v3/quotes/8123/ai-designs/51234 \
  --request DELETE \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response examples

### 200 DELETE 200 example 1

```json
{
  "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"
  }
}
```

### 400 Missing idempotency key

```json
{
  "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"
}
```

### 401 Missing API key

```json
{
  "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"
}
```

### 403 Insufficient scope

```json
{
  "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"
}
```

### 404 Unknown quote or design

```json
{
  "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"
}
```

### 409 Design not failed

```json
{
  "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"
}
```

### 422 Unknown parameter

```json
{
  "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"
}
```

### 429 Rate limited

```json
{
  "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"
}
```
