{"openapi":"3.1.0","info":{"title":"Creatimatic Agent API","version":"1.0.0","description":"Account-scoped POD tools. Mutations require an idempotency key. Marketplace publication requires seller review in Creatimatic."},"servers":[{"url":"https://creatimatic.com"}],"paths":{"/api/agents/v1":{"get":{"operationId":"discoverCreatimaticTools","summary":"Discover supported tools and input schemas","responses":{"200":{"description":"Tool catalog"}}},"post":{"operationId":"callCreatimaticTool","summary":"Execute one scoped tool","security":[{"agentKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"list_ideas"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"get_idea"},"arguments":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ideaId":{"type":"string"}},"required":["ideaId"],"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"create_idea"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"generate_artwork"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"create_template_from_idea"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"render_variations"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"list_design_templates"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"list_products"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"get_product"},"arguments":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128}},"required":["productId"],"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"list_product_templates"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"get_product_template"},"arguments":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"templateId":{"type":"string","minLength":1,"maxLength":128}},"required":["templateId"],"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"create_product_from_idea"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"update_product_draft"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"begin_mockup_batch"},"arguments":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128}},"required":["productId"],"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"prepare_mockup_upload"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"complete_mockup_upload"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments","idempotencyKey"],"properties":{"tool":{"const":"apply_mockup_batch"},"arguments":{"$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},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"get_mockup_batch"},"arguments":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batchId":{"type":"string","minLength":1,"maxLength":128}},"required":["batchId"],"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}},{"type":"object","additionalProperties":false,"required":["tool","arguments"],"properties":{"tool":{"const":"prepare_publish_review"},"arguments":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":128}},"required":["productId"],"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,100}$"}}}]}}}},"responses":{"200":{"description":"Tool result and runId"},"400":{"description":"Invalid input"},"401":{"description":"Invalid, expired or revoked key"},"403":{"description":"Missing scope or untrusted origin"},"409":{"description":"State changed, operation in progress, or idempotency conflict"},"422":{"description":"Existing workflow failed; inspect state before retrying"},"429":{"description":"60 requests per minute per key"},"503":{"description":"Credential storage unavailable"}}}}},"components":{"securitySchemes":{"agentKey":{"type":"http","scheme":"bearer","bearerFormat":"Creatimatic agent API key"}}}}