Back to Tool Reference
MCP

design.list

Paginated list of designs for the caller's org, newest first.

Effectread-onlyScopedesign:readPlanStarter+

Parameters

pageintegerDefault: 1

1-indexed.

page_sizeintegerDefault: 20

Clamped to [1, 100].

searchstring

Optional case-insensitive substring match against title.

Returns

resultsDesign[]

Each: id, url, title, type, generation_status, generation_stage, generation_progress, generation_error, prompt, catalog_product, catalog_variant_group_uuid, master_design_uuid, referenced_product_design_uuid, trend_match_uuid, created_at.

totalnumber
pagenumber
page_sizenumber
Request
json
{
  "name": "design.list",
  "arguments": {}
}
Response
json
{
  "results": [
    {
      "id": "ae07ba1f-4ab0-4fe3-880d-cb1c5bb71b3f",
      "url": "https://vaybel.com/dashboard/launch-product/ae07ba1f-4ab0-4fe3-880d-cb1c5bb71b3f",
      "title": "Cosmic Magic All-Over Print Skater Dress",
      "type": "3",
      "generation_status": "complete",
      "generation_stage": "Design generated",
      "generation_progress": 0,
      "generation_error": "",
      "prompt": "midnight blue and shades of blue with random dark purple and stars, looking cosmic, add this logo in the upper center.",
      "catalog_product": {
        "uuid": "4616bae5-c323-45e0-8e0c-e306f2c274c8",
        "title": "Printify All-Over Print Women's Skater Dress",
        "vaybel_sku": "VB-PY-AOP-DRESS-SKATER"
      },
      "catalog_variant_group_uuid": "9de36c48-9965-4011-bf61-100eae8a9f51",
      "master_design_uuid": null,
      "referenced_product_design_uuid": null,
      "trend_match_uuid": null,
      "created_at": "2026-10-09T17:15:03.778079+00:00"
    }
  ],
  "total": 284,
  "page": 1,
  "page_size": 20
}