{"name":"Creatimatic Agent API","version":"1.0.0","authentication":"Bearer agent API key","mcp":"/api/mcp","documentation":"/docs/agents","credentials":"/dashboard/settings/agents","publishing":"Seller reviews and confirms in Creatimatic; API tools do not publish.","tools":[{"name":"list_ideas","description":"List the seller's product ideas, ordered by priority and update time. Optionally filter by a search query. Use this to find an existing idea before creating a new one.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"description":"Free-text search over ideas","type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false}},{"name":"get_idea","description":"Read one idea in full, including its source artwork, design template, and where it has reached in the pipeline. Call this before acting on an existing idea.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ideaId":{"type":"string"}},"required":["ideaId"],"additionalProperties":false}},{"name":"create_idea","description":"Create a new product idea. `idea` is the concept in a sentence and `subNiche` is the audience or category it sells into — both are required. Fill in the optional fields when the user has expressed a preference; leave them out rather than inventing one.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"idea":{"type":"string","minLength":1,"description":"The concept, e.g. \"Retro llama silhouette on a tee\""},"subNiche":{"type":"string","minLength":1,"description":"Audience or category, e.g. \"llama lovers\""},"title":{"description":"Listing title, if the user named one","type":"string"},"designStyle":{"description":"e.g. \"retro 70s\", \"minimal line art\"","type":"string"},"targetCustomer":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"required":["idea","subNiche"],"additionalProperties":false}},{"name":"generate_artwork","description":"Generate the light-shirt and dark-shirt source artwork for an idea that already has a design template and center-art prompt. This spends the seller's AI credits. Use get_idea first so you have the idea id and can confirm the render setup is ready; do not use this for final template rendering or marketplace publishing.","scope":"generate","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ideaId":{"type":"string"},"ideaLabel":{"description":"The idea’s title or concept in a few words, for the approval prompt the seller reads. You will have it from get_idea or list_ideas.","type":"string"},"imageSize":{"type":"string","enum":["1K","2K","4K"]},"model":{"type":"string","enum":["gemini-3.1-flash-image-preview","gemini-3-pro-image"]},"force":{"type":"boolean"}},"required":["ideaId"],"additionalProperties":false}},{"name":"create_template_from_idea","description":"Create a template listing from an existing product idea after the seller has decided the idea is worth turning into a reusable template. Use get_idea first to identify the exact idea. This writes to the seller's catalog but does not generate artwork.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ideaId":{"type":"string"},"ideaLabel":{"description":"The idea’s title or concept in a few words, for the approval prompt the seller reads. You will have it from get_idea or list_ideas.","type":"string"}},"required":["ideaId"],"additionalProperties":false}},{"name":"render_variations","description":"Render finished light-shirt and dark-shirt designs for existing idea variations from a prepared base idea. Use this for the fast multi-variation render pass after the variation ideas already exist. The caller must provide sourceIdeaId and the exact variation ideaIds, so fetch the family with get_idea/list_ideas first; do not invent ids or use this to create the variation rows.","scope":"generate","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sourceIdeaId":{"type":"string"},"ideaIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string"}},"ideaLabel":{"description":"The idea’s title or concept in a few words, for the approval prompt the seller reads. You will have it from get_idea or list_ideas.","type":"string"}},"required":["sourceIdeaId","ideaIds"],"additionalProperties":false}},{"name":"list_design_templates","description":"List reusable design templates already in the seller's design library, with optional search text or ids. Use this before proposing or selecting a new design template for an idea. This is read-only; it does not create templates, fork templates, attach them to ideas, or render artwork.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"personalizedOnly":{"type":"boolean"},"isGlobalTemplate":{"type":"boolean"},"roles":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["ARTWORK","REUSABLE_TEMPLATE","TEMPLATE_INSTANCE","FINISHED_OUTPUT"]}},"ids":{"maxItems":100,"type":"array","items":{"type":"string"}},"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false}},{"name":"list_products","description":"Find your existing products before creating more. Includes draft and published status.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","maxLength":200},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"required":["limit"],"additionalProperties":false}},{"name":"get_product","description":"Read listing copy, supplier variants and current mockups for a product you own. Review every enabled shirt color before publishing.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128}},"required":["productId"],"additionalProperties":false}},{"name":"list_product_templates","description":"List your reusable product configurations, separate from artwork design templates.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"required":["limit"],"additionalProperties":false}},{"name":"get_product_template","description":"Read the owned source mockups and per-mask geometry, surface, color and artwork tone for native composition. Preserve those values when rendering.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"templateId":{"type":"string","minLength":1,"maxLength":128}},"required":["templateId"],"additionalProperties":false}},{"name":"create_product_from_idea","description":"Create an unpublished product using an owned idea’s attached template and saved artwork. Does not publish or generate new mockups. Compose and upload mockups through the render batch tools next.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ideaId":{"type":"string","minLength":1,"maxLength":128},"title":{"type":"string","minLength":1,"maxLength":140},"description":{"type":"string","maxLength":20000},"price":{"type":"number","exclusiveMinimum":0},"tags":{"maxItems":13,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}}},"required":["ideaId","title"],"additionalProperties":false}},{"name":"update_product_draft","description":"Update an unpublished product title, description, search tags or price. Preserves supplier mappings, artwork, gallery and personalization. Rejects published products.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128},"title":{"type":"string","minLength":1,"maxLength":140},"description":{"type":"string","maxLength":20000},"tags":{"maxItems":13,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"price":{"type":"number","exclusiveMinimum":0}},"required":["productId"],"additionalProperties":false}},{"name":"begin_mockup_batch","description":"Begin a revision-guarded gallery replacement batch. Does not render pixels. Supersedes prior pending batches for this product.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128}},"required":["productId"],"additionalProperties":false}},{"name":"prepare_mockup_upload","description":"Create a staged upload for a composed PNG. PUT the image bytes to the returned presignedUrl, then complete_mockup_upload. Never put agent credentials in the storage request.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batchId":{"type":"string","minLength":1,"maxLength":128},"templateImageId":{"type":"string","minLength":1,"maxLength":128},"slotKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"name":{"type":"string","minLength":1,"maxLength":200},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":25000000}},"required":["batchId","templateImageId","slotKey","name","bytes"],"additionalProperties":false}},{"name":"complete_mockup_upload","description":"Verify that a staged mockup reached storage before applying it to the gallery.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batchId":{"type":"string","minLength":1,"maxLength":128},"imageId":{"type":"string","minLength":1,"maxLength":128}},"required":["batchId","imageId"],"additionalProperties":false}},{"name":"apply_mockup_batch","description":"Replace selected mockups using verified batch uploads. Defaults to selected items; full-gallery replacement must be explicit. Rejects stale gallery revisions.","scope":"write","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128},"batchId":{"type":"string","minLength":1,"maxLength":128},"renderedImages":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"imageId":{"type":"string","minLength":1,"maxLength":128},"url":{"type":"string","format":"uri"},"templateImageId":{"type":"string","minLength":1,"maxLength":128},"position":{"type":"integer","minimum":0,"maximum":19},"name":{"type":"string","maxLength":200}},"required":["imageId","url","templateImageId","position"],"additionalProperties":false}},"replaceAll":{"default":false,"type":"boolean"}},"required":["productId","batchId","renderedImages","replaceAll"],"additionalProperties":false}},{"name":"get_mockup_batch","description":"Read render batch status, failures and uploaded artifacts; use this after a timeout instead of repeating a write.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batchId":{"type":"string","minLength":1,"maxLength":128}},"required":["batchId"],"additionalProperties":false}},{"name":"prepare_publish_review","description":"Return the seller’s review and Publish link. Does not queue publication. The seller must review artwork, color contrast, copy, variants and account destination in Creatimatic before clicking Publish to Etsy.","scope":"read","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128}},"required":["productId"],"additionalProperties":false}}]}