AI sign designs
list_quote_ai_designs
readList quote AI designs
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
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
The quote id, from list_quotes.
How many designs to return per page, between 1 and 100. Defaults to 20.
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.
The page of designs, newest first.
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
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
One of: neon, channel_letter, metal_cut_out
The SVG, EPS, PDF, preview and face files only when status is delivered, and the uploaded source and its preview for every status.
One of: svg, eps, illustrator_pdf, raster_preview, face_svg, source, source_preview
One of: private, public
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.
The quote file the design was converted from, or null.
One of: thumbs_up, thumbs_down
Error cases
The connection was approved without ai_sign_designs:read or without quotes:read.
The cursor belongs to another quote. Call the tool again without a cursor.
The quote id is unknown or belongs to another store.
The conversions of a quote
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_quote_ai_designs",
"arguments": {
"quote_id": 8123
}
}
}{
"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)
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_quote_ai_designs",
"arguments": {
"quote_id": 8123
}
}
}{
"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"
]
}
}
}
}