Sign Customiser

Navigation

Dark mode

AI sign designs

list_quote_ai_designs

read

List quote AI designs

Copy page

See which files of a quote were converted with the AI sign designer, and the outcome of each conversion.

Overview

List the AI designs linked to one quote of this store, newest first, with an opaque cursor: the designs made from its files with the AI sign designer, and the design a Save design form submission saved. quote_file names the quote file a design was made from, as the field_id and file_index of the quote files. Use it before create_quote_ai_design to see which files were converted. Requires ai_sign_designs:read and quotes:read. Has no side effects.

Permission

Requires theai_sign_designs:readpermission. A connection without it answersinsufficient_scopenaming the permission to approve.

Annotations

readOnlyHinttrue
destructiveHintfalse
idempotentHinttrue
openWorldHintfalse

Prerequisites

  • A quote id from list_quotes.
  • A merchant has connected this store and approved the ai_sign_designs:read and quotes:read scopes.

Arguments

quote_idintegerrequired

The quote id, from list_quotes.

limitinteger

How many designs to return per page, between 1 and 100. Defaults to 20.

cursorstring

The opaque next_cursor value from the previous page of the same quote.

Result

A page of designs and the pagination block, as get_ai_design returns each design. An erased design is not listed.

request_idstringalways present
storeobjectalways present
store.idintegeralways present
store.namestringalways present
quote_idintegeralways present
ai_designsarray of objectalways present

The page of designs, newest first.

ai_designs[].idintegeralways present
ai_designs[].originstringalways present

customer_customiser (a shopper used the AI sign designer), quote (a quote file was converted), merchant_admin (an upload in the merchant admin) or api (an AI sign design job). Expected to grow.

One of: customer_customiser, quote, merchant_admin, api

ai_designs[].statusstringalways present

processing, then delivered (a design exists), refused (a check refused the design) or failed (no design for another reason). No credit is charged for refused or failed. Expected to grow.

One of: processing, delivered, refused, failed

ai_designs[].product_familystring or null

One of: neon, channel_letter, metal_cut_out

ai_designs[].customiser_idinteger or null
ai_designs[].filesarray of objectalways present

The SVG, EPS, PDF, preview and face files only when status is delivered, and the uploaded source and its preview for every status.

ai_designs[].files[].kindstringalways present

One of: svg, eps, illustrator_pdf, raster_preview, face_svg, source, source_preview

ai_designs[].files[].purposestringalways present
ai_designs[].files[].media_typestringalways present
ai_designs[].files[].accessstringalways present

One of: private, public

ai_designs[].files[].download_urlstring or null

A URL that needs no login. For a private file of an api design it is a revocable Sign Customiser link. For a public file it is the public storage URL, which cannot be revoked. Null for every other private file.

ai_designs[].product_idsarray of integeralways present
ai_designs[].order_idsarray of integeralways present
ai_designs[].quote_idinteger or null
ai_designs[].quote_fileobject or null

The quote file the design was converted from, or null.

ai_designs[].quote_file.field_idstringalways present
ai_designs[].quote_file.file_indexintegeralways present
ai_designs[].ai_sign_design_job_idstring or null
ai_designs[].feedback_ratingstring or null

One of: thumbs_up, thumbs_down

ai_designs[].created_atstringalways present
paginationobjectalways present
pagination.has_morebooleanalways present
pagination.next_cursorstring or null

Error cases

insufficient_scope

The connection was approved without ai_sign_designs:read or without quotes:read.

invalid_cursor

The cursor belongs to another quote. Call the tool again without a cursor.

resource_not_found

The quote id is unknown or belongs to another store.

The conversions of a quote

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_quote_ai_designs",
    "arguments": {
      "quote_id": 8123
    }
  }
}
result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "quote_id": 8123,
      "ai_designs": [
        {
          "id": 51234,
          "origin": "quote",
          "status": "delivered",
          "product_family": "neon",
          "customiser_id": 42,
          "files": [
            {
              "kind": "svg",
              "purpose": "design",
              "media_type": "image/svg+xml",
              "access": "private",
              "download_url": null
            },
            {
              "kind": "source",
              "purpose": "source",
              "media_type": "image/png",
              "access": "private",
              "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": "thumbs_up",
          "created_at": "2026-10-20T09:32:00Z"
        }
      ],
      "pagination": {
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}

A connection without quotes:read (error)

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_quote_ai_designs",
    "arguments": {
      "quote_id": 8123
    }
  }
}
result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "insufficient_scope",
        "title": "Insufficient scope",
        "detail": "This operation requires the quotes:read scope.",
        "recovery": "The connection was authorised without the scope this tool needs. Ask the merchant to reconnect the Sign Customiser connector and approve the scope named in required_scopes. If the approval screen does not offer that permission, ask them to remove the connector from this AI agent and add it again. Do not retry this call.",
        "required_scopes": [
          "quotes:read"
        ],
        "granted_scopes": [
          "ai_sign_designs:read"
        ]
      }
    }
  }
}

Type a question and press Enter. Use the arrow keys to move between the results.