{"openapi":"3.1.0","info":{"title":"Mango9 Create API","version":"1.2.0","description":"Account-scoped Create and native editor API. Central sessions keep browser CSRF protection; external integrations use Authorization: Bearer <API key>. Every API key has full access to the Create operations available to its account and projects, with expiry, immediate local revocation, 120 requests/minute/key and live Central authority checks. No provider/broker credentials are exposed. All JSON envelopes include a request ID; errors have stable codes. 429/503 include Retry-After. No automatic client retries for new paid work: retry the same idempotency key. There is no browser cross-origin cookie access; use a server integration or Central-authenticated Create app."},"servers":[{"url":"/api/v1"}],"paths":{"/":{"get":{"operationId":"get_","summary":"API discovery","security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/openapi.json":{"get":{"operationId":"get__openapi_json","summary":"OpenAPI document","security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me":{"get":{"operationId":"get__me","summary":"Current API identity and permissions","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/keys":{"get":{"operationId":"get__keys","summary":"List your API keys","security":[{"centralSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiKey"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Central session required. Lists only the current actor and workspace; tokens are never returned."},"post":{"operationId":"post__keys","summary":"Issue an API key","security":[{"centralSession":[]}],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ApiKey"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Central session and same-origin request required. Every key has full account access; no permission selection is needed. Copy data.token now: only its hash is retained. Maximum 20 active keys per actor/workspace; expiry 1–90 days. Keys issued through Login as are capped to that support session and stop working when it ends.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyInput"}}}}}},"/keys/{keyId}":{"delete":{"operationId":"delete__keys_keyId","summary":"Revoke an API key","security":[{"centralSession":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/models":{"get":{"operationId":"get__models","summary":"Available models, input definitions and current prices","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["media","image","video","audio","text"],"default":"media"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"The default media catalog is unchanged. kind=text discovers models accepted by speech-edits, with availability, supported speech tasks and input/output credits per million tokens. usdPerCredit includes this account pricing multiplier. Actual job usage appears in its receipt."}},"/projects":{"get":{"operationId":"get__projects","summary":"List projects","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"integer","minimum":1},"description":"Use pagination.nextCursor to fetch the next page in descending ID order."},{"name":"projectId","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"post__projects","summary":"Create a project","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Project"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Creates a project with one empty scene by default. Returned scenes contain IDs for generation. Does not modify an existing project.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectInput"}}}}}},"/projects/{id}":{"get":{"operationId":"get__projects_id","summary":"Get one project","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Project"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"patch__projects_id","summary":"Rename a project","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Name only. Supply revision equal to the project updatedAt returned by GET. Concurrent changes return 409. Generation prompts, settings and history remain immutable.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["name","revision"],"additionalProperties":false}}}}}},"/assets":{"get":{"operationId":"get__assets","summary":"List assets","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"integer","minimum":1},"description":"Use pagination.nextCursor to fetch the next page in descending ID order."},{"name":"projectId","in":"query","schema":{"type":"integer","minimum":1}},{"name":"brandId","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Asset"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"post__assets","summary":"Upload project media","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Asset"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"},"projectId":{"type":"integer","minimum":1},"brandId":{"type":"integer","minimum":1}}}}}},"description":"Images up to 10 MiB; video/audio up to 100 MiB. Multipart form with file and projectId or brandId. Brand uploads remain available for reuse; attach them to a project to edit with them. No arbitrary remote URL imports."}},"/assets/{id}":{"get":{"operationId":"get__assets_id","summary":"Get one asset","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Asset"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generations":{"get":{"operationId":"get__generations","summary":"List generations","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"integer","minimum":1},"description":"Use pagination.nextCursor to fetch the next page in descending ID order."},{"name":"projectId","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Generation"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"post__generations","summary":"Generate a new image, video or audio result","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Generation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Generation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Model determines media kind. Image/video require a scene ID from the project; audio also accepts a new client-generated scene UUID. Prompts/settings belong to this new job. parentGenerationId links a new version to the original without modifying it. Requires current model availability, project edit access and sufficient customer wallet balance. POST replies 202 for accepted asynchronous work; replay may return 200 or 202 with the same job ID; poll GET /generations/{id}. outputs contains asset IDs. No PUT, PATCH or save operation exists for generation history.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationInput"}}}}}},"/generations/{id}":{"get":{"operationId":"get__generations_id","summary":"Get one generation","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Generation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/exports":{"get":{"operationId":"get__exports","summary":"List exports","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"integer","minimum":1},"description":"Use pagination.nextCursor to fetch the next page in descending ID order."},{"name":"projectId","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Export"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"post__exports","summary":"Render a new edited video from a clip timeline","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Export"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Export"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Clip order, trim points, transitions, motion, fit, look, volume and titles describe a new export. Existing media remains unchanged. Media must belong to and be attached to the project. Up to 80 clips / 30 minutes. Poll GET /exports/{id}; assetId identifies the completed video. Identical retries reuse the job.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportInput"}}}}}},"/exports/{id}":{"get":{"operationId":"get__exports_id","summary":"Get one export","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Export"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generations/{id}/reconcile":{"post":{"operationId":"post__generations_id_reconcile","summary":"Resume tracking an interrupted generation","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Uses only a trusted provider task ID already stored by Create. Never submits a paid generation. recovery is tracking_resumed, not_needed, or provider_confirmation_required. The last state requires administrator/provider confirmation; no charge is silently cleared and no automatic paid retry occurs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/projects/{id}/scenes":{"post":{"operationId":"post__projects_id_scenes","summary":"Add an empty scene","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Client-generated scene UUID makes identical retries safe. Existing historical scene prompts are not editable through this API.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SceneInput"}}}}}},"/projects/{id}/assets":{"post":{"operationId":"post__projects_id_assets","summary":"Attach owned media to a project","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkInput"}}}}}},"/speech-edits":{"post":{"operationId":"post__speech_edits","summary":"Translate speech captions or propose an interview edit","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Queued asynchronously; poll the Location endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Uses completed transcription reviews from one owned source asset in this project. References are snapshotted into an immutable, billed text job using the configured text provider and existing customer wallet. translate returns English cues with original ASR segment timings and uncertainty flags; offset/limit page up to 80 cues. verifyAudio=true verifies English translation against the owned original audio from one completed review, up to 300 seconds and 10 MiB; no arbitrary audio URLs are accepted. edit-plan proposes conservative cuts, chapters and a grounded opening for review; it never changes the timeline. Retry the identical request with its original key. An uncertain provider outcome requires inspection, never an automatic paid retry.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"reviewIds":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"task":{"type":"string","enum":["translate","edit-plan"]},"modelKey":{"type":"string","minLength":1,"maxLength":80},"targetLanguage":{"default":"en","type":"string","const":"en"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":4000},"limit":{"default":60,"type":"integer","minimum":1,"maximum":80},"verifyAudio":{"type":"boolean"},"instruction":{"default":"","type":"string","maxLength":2000}},"required":["projectId","reviewIds","task","modelKey"],"additionalProperties":false}}}}}},"/speech-edits/{jobId}":{"get":{"operationId":"get__speech_edits_jobId","summary":"Read a speech translation or interview edit plan","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"States follow text jobs: queued, processing, completed, failed, review. A completed result includes validated translation or edit-plan JSON. A failed validation returns result=null and a bounded private diagnostic containing the rejected output; it must never be applied as an edit. Usage and estimated/actual credits stay in the normal account history. Source ASR times are preserved, not forced-aligned English word timings."}},"/uploads":{"post":{"operationId":"post__uploads","summary":"Begin a resumable media upload","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"PNG/JPEG/WebP images, MP4/MOV video and MP3/WAV/OGG/FLAC/M4A/AAC audio. Optional mime identifies the media type; omitted mime preserves video compatibility. Reserves disk capacity and expires in 24 hours. Finished assets are private in Wasabi. Images normalize to PNG, audio to MP3, and video to H.264/AAC at 30 fps with maximum dimension 1920. API intake supports 25 GiB; chat attachments accept 5 GiB. Existing image pixel, audio duration and video duration validation applies. Poll status for the resulting assetId. Original client file is unchanged; the transient server original is removed after processing.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"type":"string","minLength":1,"maxLength":120},"size":{"type":"integer","minimum":1,"maximum":26843545600},"mime":{"type":"string","enum":["image/png","image/jpeg","image/webp","video/mp4","video/quicktime","audio/mpeg","audio/mp3","audio/wav","audio/x-wav","audio/ogg","audio/flac","audio/x-flac","audio/mp4","audio/x-m4a","audio/aac"]}},"required":["projectId","name","size"],"additionalProperties":false}}}}}},"/uploads/{uploadId}":{"get":{"operationId":"get__uploads_uploadId","summary":"Read resumable upload status","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"delete__uploads_uploadId","summary":"Cancel an unfinished upload","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Does not delete an already completed asset."}},"/uploads/{uploadId}/chunks":{"put":{"operationId":"put__uploads_uploadId_chunks","summary":"Stream the next media chunk","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Upload-Offset","in":"header","required":true,"schema":{"type":"integer","minimum":0}},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer","minimum":1,"maximum":33554432}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"description":"Up to 32 MiB. Send the exact receivedBytes offset from GET. An interrupted chunk is rolled back. After a lost response, read status before retrying; a stale offset returns 409."}},"/uploads/{uploadId}/complete":{"post":{"operationId":"post__uploads_uploadId_complete","summary":"Queue completed bytes for media processing","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Queued asynchronously; poll the Location endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Requires receivedBytes=size. Repeating completion is safe. Read state and error; only completed has assetId.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/assets/{id}/content":{"get":{"operationId":"get__assets_id_content","summary":"Stream media or a thumbnail","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Range","in":"header","schema":{"type":"string"},"example":"bytes=0-1023"},{"name":"download","in":"query","schema":{"type":"string"}},{"name":"thumbnail","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Binary media"},"206":{"description":"Partial binary media"},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unavailable media","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Expired media","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"416":{"description":"Invalid byte range"}},"description":"thumbnail=1 returns a bounded JPEG preview for still images, or the stored poster for a video. Omit thumbnail for original bytes. Originals remain unchanged."}},"/projects/{id}/editor/session":{"get":{"operationId":"get__projects_id_editor_session","summary":"Read native editor session status","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorSession"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorSession"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"post__projects_id_editor_session","summary":"Start or reconnect to the native editor","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorSession"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorSession"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Maps to the existing editor broker. The project ID makes reconnects safe. 202 means starting; poll GET on this endpoint. editorUrl opens the interactive editor and requires a Central browser session with project edit access. API keys are never placed in editor URLs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/projects/{id}/editor/sync":{"post":{"operationId":"post__projects_id_editor_sync","summary":"Sync owned project media into the native editor","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorSession"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorSession"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/projects/{id}/editor/exports":{"get":{"operationId":"get__projects_id_editor_exports","summary":"List native exports pending delivery to Create","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Maps to the editor export API. Pending files are transient: the existing worker imports them into Create assets. For durable retrieval use GET /assets?projectId=... and GET /assets/{id}/content. No public acknowledgement or purge operation is exposed."}},"/projects/{id}/editor/exports/{token}/content":{"get":{"operationId":"get__projects_id_editor_exports_token_content","summary":"Download a pending native export","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"token","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"200":{"description":"video/mp4 stream"},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Already imported or not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/balance":{"get":{"operationId":"get__balance","summary":"Read the current Mango9 wallet balance","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Balance"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Returns the owning account’s current shared wallet balance in integer USD cents. Also returns reservedCents and availableCents (balance minus known reservations, floored at zero), reservationScope=this_create_server, and asOf. Reservations only cover this Create server, not other apps sharing the wallet. Values are a point-in-time estimate; generation admission rechecks affordability. Read-only: no balance mutation endpoint is provided."}},"/brands":{"get":{"operationId":"get__brands","summary":"List account brands","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"integer","minimum":1},"description":"Use pagination.nextCursor to fetch the next page in descending ID order."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Brand"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"post__brands","summary":"Create a brand library","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Brand"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Creates a named library for the account owner. Upload permanent brand media with POST /assets using brandId.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandInput"}}}}}},"/brands/{id}":{"get":{"operationId":"get__brands_id","summary":"Read a brand","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Brand"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/brands/{id}/assets":{"get":{"operationId":"get__brands_id_assets","summary":"List a brand’s assets","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"integer","minimum":1},"description":"Use pagination.nextCursor to fetch the next page in descending ID order."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Asset"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Attach selected asset IDs to a project with POST /projects/{id}/assets, then sync its editor. The original brand asset remains unchanged."}},"/editor/catalog":{"get":{"operationId":"get__editor_catalog","summary":"Full editor capabilities and settings","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Discovery from the installed native editor. Properties include supported types, defaults, writable status, numeric bounds and choices. The catalog marks analysis tools that still require the interactive editor."}},"/editor/effects":{"get":{"operationId":"get__editor_effects","summary":"All installed effects and their properties","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Discovery from the installed native editor. Properties include supported types, defaults, writable status, numeric bounds and choices. The catalog marks analysis tools that still require the interactive editor."}},"/editor/transitions":{"get":{"operationId":"get__editor_transitions","summary":"All installed transition designs","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Discovery from the installed native editor. Properties include supported types, defaults, writable status, numeric bounds and choices. The catalog marks analysis tools that still require the interactive editor."}},"/editor/captions":{"get":{"operationId":"get__editor_captions","summary":"Caption styles, appearance settings and animations","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Discovery from the installed native editor. Properties include supported types, defaults, writable status, numeric bounds and choices. The catalog marks analysis tools that still require the interactive editor."}},"/editor/fonts":{"get":{"operationId":"get__editor_fonts","summary":"Installed caption font families","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Discovery from the installed native editor. Properties include supported types, defaults, writable status, numeric bounds and choices. The catalog marks analysis tools that still require the interactive editor."}},"/projects/{id}/editor/timeline":{"get":{"operationId":"get__projects_id_editor_timeline","summary":"Read the native editor’s current timeline and settings","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorTimeline"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Start the editor session first. Returns the same tracks, media clips, audio, captions, effects, transitions, profile, saved caption presets and export progress shown in the editor. revision changes whenever the timeline changes. assets[].imported reports native media readiness. Server file paths are not exposed. export.contentUrl identifies a completed video after import into Create."}},"/projects/{id}/editor/commands":{"post":{"operationId":"post__projects_id_editor_commands","summary":"Edit the native timeline, captions, effects and audio","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Runs one command in the native editor and persists it automatically. Use the revision from GET /projects/{id}/editor/timeline and a new Idempotency-Key. The full request schema lists every command. Supports tracks; image, video and audio clips; trim, split, duplicate, placement and properties; property keyframes; effect settings and masks; transitions; caption text, all appearance controls, SRT/VTT, project presets; profile; undo/redo; and render. Audio-only clip.add commands default to has_video:0 so they cannot obscure lower video tracks. Explicit has_video or waveform settings are preserved. Asset IDs must be attached and synced; wait for assets[].imported in the timeline response. Poll statusUrl when state is queued or running; a completed operation returns the new revision. failed, expired and unknown states require inspection before a new request. Historical generation records and source media never change.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorCommandInput"}}}}}},"/projects/{id}/editor/render":{"post":{"operationId":"post__projects_id_editor_render","summary":"Render the current complete native timeline","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Exports the actual native timeline, including audio, overlays, captions and effects, through the existing editor renderer. Uses revision and Idempotency-Key. Poll the command’s statusUrl for acceptance, then GET /projects/{id}/editor/timeline for export.state/progress. When imported, export.assetId and export.contentUrl identify the durable completed video. Pending native files are also available under the editor exports endpoints. Maximum finished duration is 30 minutes and exported file size is 4 GiB. Completed renders stream into private storage without another video encode.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorRenderInput"}}}}}},"/projects/{id}/editor/operations/{operationId}":{"get":{"operationId":"get__projects_id_editor_operations_operationId","summary":"Read an editor command result","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"operationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Use the statusUrl returned by a command. States: queued, running, completed, failed, expired, unknown. Retrying the identical request with its original idempotency key retrieves its receipt and never applies it twice."}},"/exports/{id}/content":{"get":{"operationId":"get__exports_id_content","summary":"Download a completed export video","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Range","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"video/mp4 attachment"},"206":{"description":"Partial video bytes"},"409":{"description":"Export is not ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Authenticated attachment download for a completed Create or native-editor export. Supports byte ranges. Returns 409 while the export is not ready. The asset’s normal availability period applies."}},"/assets/{id}/reviews":{"post":{"operationId":"post__assets_id_reviews","summary":"Review rendered frames, sound, motion and captions","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/MediaReview"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/MediaReview"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Queues private asynchronous analysis of an owned asset. Checks: metadata, frames, audio, motion, transcript, captions. Optional renderId binds evidence to a completed render, its caption timings and revision. Returns authenticated JPEGs, a contact sheet, waveform JSON, WAV and SRT/VTT as requested. expectedScript compares actual recognized speech, never fabricates timings. Raw word probabilities remain available; minWordProbability filters comparison and suggested subtitles. English numeric discounts (50% / fifty percent) normalize equivalently. Set caption role to title, brand, contact or disclosure for nonspoken overlays. expectSpeech=false checks instrumental tracks for unexpected speech. audioRole=voice treats short narration pauses as informational. frameMaxDimension up to 1920 returns sharper frames; OCR confidence is configurable and remains sampled evidence. Maximum 600 seconds per review range on sources up to 30 minutes and 4 GiB, 24 frames and 10 queued/running reviews per account. Range timestamps are relative to the selected interval; timeOrigin records its source offset. captionLanguage skips cross-language word matching without claiming semantic verification. Artifacts expire after 7 days. Retry identical inputs with the same key.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"range":{"type":"object","properties":{"start":{"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","exclusiveMinimum":0,"maximum":1800}},"required":["start","end"],"additionalProperties":false},"transcriptionQuality":{"type":"string","enum":["standard","high"]},"captionLanguage":{"type":"string","pattern":"^[a-z]{2,3}$"},"checks":{"default":["metadata","frames","audio","motion"],"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["metadata","frames","audio","motion","transcript","captions","visual"]}},"safeArea":{"default":{"left":0.05,"right":0.05,"top":0.1,"bottom":0.15},"type":"object","properties":{"left":{"type":"number","minimum":0,"maximum":0.4},"right":{"type":"number","minimum":0,"maximum":0.4},"top":{"type":"number","minimum":0,"maximum":0.4},"bottom":{"type":"number","minimum":0,"maximum":0.4}},"required":["left","right","top","bottom"],"additionalProperties":false},"protectedRegions":{"default":[],"maxItems":50,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1},"start":{"type":"number","minimum":0,"maximum":600},"end":{"type":"number","minimum":0,"maximum":600}},"required":["name","x","y","width","height","start","end"],"additionalProperties":false}},"timestamps":{"minItems":1,"maxItems":24,"type":"array","items":{"type":"number","minimum":0,"maximum":600}},"renderId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"frameMaxDimension":{"default":640,"type":"integer","minimum":320,"maximum":1920},"minWordProbability":{"default":0.2,"type":"number","minimum":0,"maximum":1},"expectSpeech":{"default":true,"type":"boolean"},"ocrMinConfidence":{"default":60,"type":"number","minimum":0,"maximum":100},"audioRole":{"default":"mix","type":"string","enum":["mix","voice","music","sound"]},"expectedScript":{"type":"string","maxLength":10000},"language":{"type":"string","pattern":"^[a-z]{2,3}$"},"expectAudio":{"default":true,"type":"boolean"},"targetLufs":{"default":-16,"type":"number","minimum":-30,"maximum":-8},"maxTruePeakDbtp":{"default":-1,"type":"number","minimum":-6,"maximum":0},"silenceThresholdDb":{"default":-50,"type":"number","minimum":-80,"maximum":-20},"captions":{"maxItems":300,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","minLength":1,"maxLength":2000},"role":{"default":"subtitle","type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"start":{"type":"number","minimum":0,"maximum":600},"end":{"type":"number","minimum":0,"maximum":600}},"required":["text","start","end"],"additionalProperties":false}},"intentionalIntervals":{"default":[],"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["black","freeze","silence","flicker"]},"start":{"type":"number","minimum":0,"maximum":600},"end":{"type":"number","minimum":0,"maximum":600},"reason":{"type":"string","minLength":1,"maxLength":300}},"required":["type","start","end","reason"],"additionalProperties":false}}},"additionalProperties":false}}}}},"get":{"operationId":"get__assets_id_reviews","summary":"List this asset’s review jobs","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"string","format":"uuid"},"description":"Use pagination.nextCursor."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MediaReview"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/assets/{id}/transcriptions":{"post":{"operationId":"post__assets_id_transcriptions","summary":"Transcribe speech and return word-timed captions","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/MediaReview"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/MediaReview"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Queues a review with transcript and captions enabled. Use checks:[\"transcript\",\"captions\"] for transcription only. Returns recognized words, timestamps, probability, SRT/VTT and optional expected-script/caption comparison. Import the SRT/VTT with the existing caption.import command.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"range":{"type":"object","properties":{"start":{"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","exclusiveMinimum":0,"maximum":1800}},"required":["start","end"],"additionalProperties":false},"transcriptionQuality":{"type":"string","enum":["standard","high"]},"captionLanguage":{"type":"string","pattern":"^[a-z]{2,3}$"},"checks":{"default":["metadata","frames","audio","motion"],"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["metadata","frames","audio","motion","transcript","captions","visual"]}},"safeArea":{"default":{"left":0.05,"right":0.05,"top":0.1,"bottom":0.15},"type":"object","properties":{"left":{"type":"number","minimum":0,"maximum":0.4},"right":{"type":"number","minimum":0,"maximum":0.4},"top":{"type":"number","minimum":0,"maximum":0.4},"bottom":{"type":"number","minimum":0,"maximum":0.4}},"required":["left","right","top","bottom"],"additionalProperties":false},"protectedRegions":{"default":[],"maxItems":50,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1},"start":{"type":"number","minimum":0,"maximum":600},"end":{"type":"number","minimum":0,"maximum":600}},"required":["name","x","y","width","height","start","end"],"additionalProperties":false}},"timestamps":{"minItems":1,"maxItems":24,"type":"array","items":{"type":"number","minimum":0,"maximum":600}},"renderId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"frameMaxDimension":{"default":640,"type":"integer","minimum":320,"maximum":1920},"minWordProbability":{"default":0.2,"type":"number","minimum":0,"maximum":1},"expectSpeech":{"default":true,"type":"boolean"},"ocrMinConfidence":{"default":60,"type":"number","minimum":0,"maximum":100},"audioRole":{"default":"mix","type":"string","enum":["mix","voice","music","sound"]},"expectedScript":{"type":"string","maxLength":10000},"language":{"type":"string","pattern":"^[a-z]{2,3}$"},"expectAudio":{"default":true,"type":"boolean"},"targetLufs":{"default":-16,"type":"number","minimum":-30,"maximum":-8},"maxTruePeakDbtp":{"default":-1,"type":"number","minimum":-6,"maximum":0},"silenceThresholdDb":{"default":-50,"type":"number","minimum":-80,"maximum":-20},"captions":{"maxItems":300,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"text":{"type":"string","minLength":1,"maxLength":2000},"role":{"default":"subtitle","type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"start":{"type":"number","minimum":0,"maximum":600},"end":{"type":"number","minimum":0,"maximum":600}},"required":["text","start","end"],"additionalProperties":false}},"intentionalIntervals":{"default":[],"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["black","freeze","silence","flicker"]},"start":{"type":"number","minimum":0,"maximum":600},"end":{"type":"number","minimum":0,"maximum":600},"reason":{"type":"string","minLength":1,"maxLength":300}},"required":["type","start","end","reason"],"additionalProperties":false}}},"additionalProperties":false}}}}}},"/media-reviews/{reviewId}":{"get":{"operationId":"get__media_reviews_reviewId","summary":"Read review progress and audiovisual evidence","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/MediaReview"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Job states: queued, running, completed, failed, cancelled. Completion means analysis finished. Optional transcriptionQuality=high uses the installed multilingual large-v3-turbo recognizer; omitted quality preserves the standard model. Transcript evidence identifies its engine/model and includes recognition confidence signals. Recognition still needs editorial review. Inspect result.status and each check: pass, warning, fail, not_checked or unavailable. coverageComplete is false if any check was not performed. Findings include output/timeline timestamps, clip IDs and intentional-interval markers."}},"/media-reviews/{reviewId}/cancel":{"post":{"operationId":"post__media_reviews_reviewId_cancel","summary":"Cancel a queued or running review","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/MediaReview"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Idempotent cancellation. Completed jobs stay completed; running work observes cancellation within its heartbeat interval.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/media-reviews/{reviewId}/artifacts/{name}":{"get":{"operationId":"get__media_reviews_reviewId_artifacts_name","summary":"Read a private review artifact","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Private artifact bytes"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Review incomplete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Artifact expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Use the returned artifact contentUrl. Requires access to the source asset/project. JPEG, WAV, waveform JSON, SRT and VTT expire after 7 days. A tool adapter forwards JPEG bytes as image content for model inspection."}},"/projects/{id}/editor/previews":{"post":{"operationId":"post__projects_id_editor_previews","summary":"Render a time range at preview resolution","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["id","state","statusUrl"],"properties":{"id":{"type":"string","format":"uuid"},"state":{"enum":["queued","running","completed","failed","expired","unknown"]},"statusUrl":{"type":"string"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"data":{"type":["object","null"],"additionalProperties":true},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"renderUrl":{"type":"string"}}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Uses the native renderer and exact revision with a selected range and bounded dimensions. Preserves aspect ratio and the production profile. Poll statusUrl for command acceptance, then renderUrl for rendering/uploading/completed/failed. Each preview is a new output.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"start":{"default":0,"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","exclusiveMinimum":0,"maximum":1800},"maxWidth":{"default":640,"type":"integer","minimum":160,"maximum":1920},"maxHeight":{"default":640,"type":"integer","minimum":160,"maximum":1920}},"required":["revision","end"],"additionalProperties":false}}}}}},"/projects/{id}/editor/renders":{"get":{"operationId":"get__projects_id_editor_renders","summary":"List completed versioned native renders","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"after","in":"query","schema":{"type":"string","format":"uuid"},"description":"Use pagination.nextCursor."},{"name":"view","in":"query","schema":{"type":"string","enum":["full","compact"],"default":"full"},"description":"compact omits the potentially large timeline snapshot when polling. full preserves the existing response."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EditorRender"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Lists final and preview renders created after feedback API deployment. Preserves source revision, timeline snapshot, output range/profile and asset ID."}},"/projects/{id}/editor/renders/{renderId}":{"get":{"operationId":"get__projects_id_editor_renders_renderId","summary":"Read a render version and its status","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"renderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"view","in":"query","schema":{"type":"string","enum":["full","compact"],"default":"full"},"description":"compact omits the potentially large timeline snapshot when polling. full preserves the existing response."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorRender"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"The render ID is the accepted native render operation ID. Progress comes from its persistent native receipt. After import, Create retains the snapshot and asset mapping independently of the editor session. Output time origin is settings.start. Command completion is not render completion."}},"/projects/{id}/editor/batches":{"post":{"operationId":"post__projects_id_editor_batches","summary":"Apply or dry-run an atomic group of edits","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EditorOperation"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"1–100 edits in one native transaction. On failure all edits roll back. dryRun validates with the real editor and restores the timeline and undo/redo history. Later edits may reference earlier result IDs using $result.0.trackId or $result.1.clipId. No render, undo or redo inside a batch. Read the operation receipt; interrupted operations remain unknown and require inspection.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"commands":{"minItems":1,"maxItems":100,"type":"array","items":{"oneOf":[{"type":"object","properties":{"action":{"type":"string","const":"track.add"},"name":{"type":"string","minLength":1,"maxLength":160},"number":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000}},"required":["action","name"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"track.update"},"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":160},"locked":{"type":"boolean"}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"track.delete"},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.add"},"assetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"default":0,"type":"number","minimum":0,"maximum":1800},"start":{"default":0,"type":"number","minimum":0,"maximum":3600},"end":{"type":"number","exclusiveMinimum":0,"maximum":3600},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}}},"required":["action","assetId","trackId","end"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.update"},"id":{"type":"string","minLength":1,"maxLength":80},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"start":{"type":"number","minimum":0,"maximum":3600},"end":{"type":"number","exclusiveMinimum":0,"maximum":3600},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.delete"},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.split"},"id":{"type":"string","minLength":1,"maxLength":80},"at":{"type":"number","minimum":0,"maximum":1800}},"required":["action","id","at"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.duplicate"},"id":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"trackId":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"effect.add"},"clipId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}},"maskAssetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"transitionId":{"type":"string","maxLength":250}},"required":["action","clipId","type"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"effect.update"},"clipId":{"type":"string","minLength":1,"maxLength":80},"id":{"type":"string","minLength":1,"maxLength":80},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}},"maskAssetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"transitionId":{"type":"string","maxLength":250}},"required":["action","clipId","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"effect.delete"},"clipId":{"type":"string","minLength":1,"maxLength":80},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","clipId","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transition.add"},"transitionId":{"type":"string","minLength":1,"maxLength":250},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"reverse":{"default":false,"type":"boolean"}},"required":["action","transitionId","trackId","position","duration"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transition.update"},"id":{"type":"string","minLength":1,"maxLength":80},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"start":{"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","minimum":0,"maximum":1800},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transition.delete"},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.add"},"text":{"type":"string","minLength":1,"maxLength":2000},"position":{"type":"number","minimum":0,"maximum":1800},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","text","position","duration"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.update"},"id":{"type":"string","minLength":1,"maxLength":80},"text":{"type":"string","minLength":1,"maxLength":2000},"position":{"type":"number","minimum":0,"maximum":1800},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.import"},"text":{"type":"string","minLength":1,"maxLength":300000},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","text"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.styleAll"},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","format"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.preset"},"name":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","name","format"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"profile.set"},"width":{"type":"integer","minimum":32,"maximum":3840},"height":{"type":"integer","minimum":32,"maximum":3840},"fps":{"type":"object","properties":{"num":{"type":"integer","minimum":1,"maximum":60000},"den":{"type":"integer","minimum":1,"maximum":1001}},"required":["num","den"],"additionalProperties":false}},"required":["action","width","height","fps"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"undo"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"redo"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"render"}},"required":["action"],"additionalProperties":false}]}},"dryRun":{"default":false,"type":"boolean"}},"required":["revision","commands"],"additionalProperties":false}}}}}},"/assets/{id}/finishes":{"post":{"operationId":"post__assets_id_finishes","summary":"Normalize audio, duck music and encode a new derivative","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProductionJob"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProductionJob"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Optional isolated voice and music stems use timeline offsets in seconds. Music ducking uses voice, or the retained source audio as its sidechain. For reliable voice-driven ducking provide an isolated voice stem and sourceAudio=replace. Uses two-pass loudness normalization and remeasures encoded AAC. Returns pass/warning measurements, never an intelligibility guarantee. MP4 H.264/AAC, or M4A AAC for audio-only. Images require duration and voice/music. Outputs up to 1080p area and 30 minutes. Source video and output support 4 GiB; isolated audio stems remain limited to 1 GiB. Original media stays unchanged.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"default":"Finished media","type":"string","minLength":1,"maxLength":120},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"voice":{"type":"object","properties":{"assetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"start":{"default":0,"type":"number","minimum":0,"maximum":1800},"gainDb":{"default":0,"type":"number","minimum":-40,"maximum":12}},"required":["assetId"],"additionalProperties":false},"music":{"type":"object","properties":{"assetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"start":{"default":0,"type":"number","minimum":0,"maximum":1800},"gainDb":{"default":-14,"type":"number","minimum":-40,"maximum":0},"duck":{"default":true,"type":"boolean"}},"required":["assetId"],"additionalProperties":false},"sourceAudio":{"default":"keep","type":"string","enum":["keep","replace"]},"targetLufs":{"default":-16,"type":"number","minimum":-30,"maximum":-8},"maxTruePeakDbtp":{"default":-1,"type":"number","minimum":-6,"maximum":-0.5},"output":{"type":"object","properties":{"width":{"type":"integer","minimum":160,"maximum":1920},"height":{"type":"integer","minimum":160,"maximum":1920},"fit":{"default":"contain","type":"string","enum":["contain","cover"]},"fps":{"default":"30","type":"string","enum":["24","25","30","60"]},"quality":{"default":"high","type":"string","enum":["standard","high"]},"audioBitrateKbps":{"default":"192","type":"string","enum":["128","192","256"]}},"required":["width","height"],"additionalProperties":false},"retention":{"default":"30_days","type":"string","enum":["30_days","permanent"]}},"additionalProperties":false}}}}}},"/assets/{id}/archive":{"post":{"operationId":"post__assets_id_archive","summary":"Create a permanent campaign copy","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProductionJob"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProductionJob"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Copies the owned source bytes into durable private storage and creates a new asset with no automatic expiry. Does not restore already expired media. Account deletion still removes campaign copies.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"default":"Campaign master","type":"string","minLength":1,"maxLength":120}},"additionalProperties":false}}}}}},"/production-jobs":{"get":{"operationId":"get__production_jobs","summary":"List production work","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductionJob"}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Use projectId for team project access, or account owner access for the account-wide queue. limit 1–100 and after UUID paginate results."}},"/production-jobs/{jobId}":{"get":{"operationId":"get__production_jobs_jobId","summary":"Read job status and output measurements","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProductionJob"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/production-jobs/{jobId}/cancel":{"post":{"operationId":"post__production_jobs_jobId_cancel","summary":"Cancel queued or running media finishing","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProductionJob"},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"A native editor transaction already applying cannot be cancelled; inspect its operation and use a new edit to revert if needed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/templates":{"get":{"operationId":"get__templates","summary":"List latest immutable template versions","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Account owner library. limit 1–100; after UUID paginates templates."},"post":{"operationId":"post__templates","summary":"Publish a versioned brand template","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Owner account library. Supply a client UUID, version 1, named typed slots and editor commands. Whole-value {{slotName}} placeholders are substituted. choices enforce brand color/font/text rules. Publish the next sequential version for changes; older versions remain reproducible.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":100000},"name":{"type":"string","minLength":1,"maxLength":120},"brandId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"slots":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z][a-zA-Z0-9_]{0,39}$"},"additionalProperties":{"type":"object","properties":{"type":{"type":"string","enum":["text","number","asset","color"]},"default":{"anyOf":[{"type":"string","maxLength":2000},{"type":"number"}]},"choices":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"string","maxLength":2000},{"type":"number"}]}}},"required":["type","default"],"additionalProperties":false}},"commands":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/Inline0/$defs/__schema0"}}}},"required":["id","version","name","slots","commands"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/Inline0/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/Inline0/$defs/__schema0"}}]}}}}}}}},"/templates/{templateId}":{"get":{"operationId":"get__templates_templateId","summary":"Get a template version","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates/{templateId}/variants":{"post":{"operationId":"post__templates_templateId_variants","summary":"Queue template variants into separate projects","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated UUID. Retry the identical request with the same key. Changed inputs require a new key; reuse with different inputs returns 409. Keys are scoped to the owning account.","schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"batchId":{"type":"string","format":"uuid"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductionJob"}}}},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"1–20 already-started editor projects, each with current revision and synced assets. Each variant is an atomic edit transaction and a separate job. Include profile.set in the template for aspect variants. dryRun restores each target. Poll items, then render the completed revisions. Retrying an interrupted submission uses the same key to recover the same item jobs. No cross-project transaction is claimed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dryRun":{"default":false,"type":"boolean"},"variants":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"projectId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"values":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":2000},{"type":"number"}]}}},"required":["projectId","revision"],"additionalProperties":false}}},"required":["version","variants"],"additionalProperties":false}}}}}},"/webhooks":{"get":{"operationId":"get__webhooks","summary":"List delivery endpoints","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Account owner settings; signing secrets are never listed."},"post":{"operationId":"post__webhooks","summary":"Register a signed HTTPS completion webhook","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Returns a signing secret once. Public HTTPS/443 destinations with public IPv4 DNS only. Redirects and private/reserved addresses are rejected. Supports production/review terminal events and completed native renders created after registration. Delivery is at least once: deduplicate body.id. Verify HMAC-SHA256(secret, X-Mango9-Timestamp + \".\" + exact raw body), compare with X-Mango9-Signature v1=hex, and reject timestamps outside five minutes. No API keys or media bytes are sent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"events":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["production.completed","production.failed","production.cancelled","review.completed","review.failed","review.cancelled","render.completed"]}}},"required":["url","events"],"additionalProperties":false}}}}}},"/webhooks/{webhookId}":{"delete":{"operationId":"delete__webhooks_webhookId","summary":"Disable a webhook","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks/{webhookId}/deliveries":{"get":{"operationId":"get__webhooks_webhookId_deliveries","summary":"Inspect webhook attempts and delivery history","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"limit 1–100 and after UUID paginate history. Retries use exponential backoff from 30 seconds, capped at six hours, with 12 automatic attempts. Non-2xx and redirects fail. The event ID is stable across retries."}},"/webhooks/{webhookId}/deliveries/{deliveryId}/retry":{"post":{"operationId":"post__webhooks_webhookId_deliveries_deliveryId_retry","summary":"Retry an exhausted webhook delivery","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/production-status":{"get":{"operationId":"get__production_status","summary":"Read account queue and delivery telemetry","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Counts by kind/state, oldest job age, capacity limits and delivery failures. Least recently served account goes first; FIFO within an account. This is operational telemetry, not an SLA."}},"/assets/{id}/delivery-link":{"post":{"operationId":"post__assets_id_delivery_link","summary":"Create or reuse a revocable media delivery link","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Maps to the existing Create share API. Returns a share page and direct downloadUrl for tools that cannot send an Authorization header. Anyone holding the link can read this asset until revocation, source expiry or account suspension; keep it private. Does not make an account library public. Creating a link does not send it anywhere.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}},"delete":{"operationId":"delete__assets_id_delivery_link","summary":"Revoke delivery links for this asset","security":[{"centralSession":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Error; inspect error.code, error.message and meta.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Immediately revokes the existing Create share link for this asset, including one created in the user interface."}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"m9c_<64 hex>"},"centralSession":{"type":"apiKey","in":"cookie","name":"__Host-m9-create","description":"Central-managed HttpOnly cookie. Mutations require Origin equal to Create origin. Login as uses its scoped HttpOnly cookie and x-m9-support selector."}},"schemas":{"Balance":{"type":"object","required":["balanceCents","currency"],"properties":{"balanceCents":{"type":"integer"},"reservedCents":{"type":"integer","minimum":0},"availableCents":{"type":"integer","minimum":0},"reservationScope":{"const":"this_create_server"},"asOf":{"type":"string","format":"date-time"},"currency":{"const":"USD"}}},"Brand":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"description":{"type":"string"}}},"Project":{"type":"object","required":["id","scenes"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"brandId":{"type":"integer","minimum":1},"aspectRatio":{"type":"string","enum":["16:9","9:16","1:1"]},"scenes":{"type":"array","items":{"type":"object","required":["id","title"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"image":{"type":"integer","minimum":1},"video":{"type":"integer","minimum":1},"audio":{"type":"integer","minimum":1}}}}}},"Asset":{"type":"object","required":["id","contentUrl"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"projectId":{"type":"integer","minimum":1},"brandId":{"type":"integer","minimum":1},"mime":{"type":"string"},"size":{"type":["number","null"]},"duration":{"type":["number","null"]},"category":{"type":["string","null"]},"source":{"type":["string","null"]},"generationId":{"type":["integer","null"]},"expiresAt":{"type":["string","null"],"format":"date-time"},"deletedAt":{"type":["string","null"],"format":"date-time"},"contentUrl":{"type":"string"}}},"Generation":{"type":"object","required":["id","state"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"projectId":{"type":"integer","minimum":1},"sceneId":{"type":"string","format":"uuid"},"kind":{"enum":["image","video","audio"]},"modelKey":{"type":"string"},"modelLabel":{"type":"string"},"prompt":{"type":"string"},"settings":{"type":"object","additionalProperties":true},"references":{"type":"array","items":{"type":"integer","minimum":1}},"state":{"type":"string","description":"queued, waiting, submitting, processing, completed, failed, cancelled, or blocked"},"parentGenerationId":{"type":["integer","null"]},"outputs":{"type":["array","null"],"items":{"type":"integer","minimum":1}},"estimatedCredits":{"type":["number","null"]},"actualCredits":{"type":["number","null"]},"submittedAt":{"type":["string","null"],"format":"date-time"},"error":{"type":["object","null"]}}},"Export":{"type":"object","required":["id","state"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"projectId":{"type":"integer","minimum":1},"clips":{"minItems":1,"maxItems":80,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"assetId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"start":{"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","exclusiveMinimum":0,"maximum":1800},"transition":{"default":"cut","type":"string","enum":["cut","dissolve","fade-black","wipe-left","wipe-right","wipe-up","wipe-down","slide-left","slide-right","zoom-in"]},"transitionDuration":{"default":0.6,"type":"number","minimum":0.1,"maximum":2},"motion":{"default":"none","type":"string","enum":["none","zoom-in","zoom-out","pan-left","pan-right","rise","rotate-in","pulse"]},"fit":{"default":"contain","type":"string","enum":["contain","cover"]},"look":{"default":"none","type":"string","enum":["none","warm","cool","mono"]},"title":{"default":"","type":"string","maxLength":160},"titlePosition":{"default":"bottom","type":"string","enum":["top","center","bottom"]},"volume":{"default":1,"type":"number","minimum":0,"maximum":1}},"required":["assetId","start","end"]}},"aspectRatio":{"type":"string"},"state":{"type":"string","enum":["queued","processing","native-importing","completed","failed"]},"assetId":{"type":["integer","null"]},"contentUrl":{"type":["string","null"]},"error":{"type":["object","null"]}}},"EditorSession":{"type":"object","required":["projectId","state","editorUrl"],"properties":{"projectId":{"type":"integer","minimum":1},"state":{"type":"string"},"editorUrl":{"type":"string"},"imported":{"type":"number"},"lastSeen":{"type":["number","null"]},"app":{"type":["object","null"]},"cloudExport":{"type":["object","null"]},"error":{"type":["string","null"]}}},"ApiKey":{"type":"object","required":["id","name","scopes","expiresAt"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"scopes":{"type":"array","deprecated":true,"description":"Legacy compatibility metadata. Keys have no separate read/write restrictions; account and project permissions apply.","items":{"type":"string","enum":["projects:read","projects:write","models:read","assets:read","assets:write","generations:read","generations:write","editor:read","editor:write","exports:read","exports:write"]}},"createdAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"revokedAt":{"type":["string","null"],"format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"token":{"type":"string","description":"Present only in the key-creation response; never returned again."}}},"EditorOperation":{"type":"object","required":["id","state","statusUrl"],"properties":{"id":{"type":"string","format":"uuid"},"state":{"enum":["queued","running","completed","failed","expired","unknown"]},"statusUrl":{"type":"string"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"data":{"type":["object","null"],"additionalProperties":true},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"EditorTimeline":{"type":"object","required":["apiVersion","revision","tracks","clips","assets"],"properties":{"apiVersion":{"const":1},"updatedAt":{"type":"number"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"profile":{"type":"object","properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1},"fps":{"type":"object","properties":{"num":{"type":"integer","minimum":1},"den":{"type":"integer","minimum":1}}}}},"tracks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"number":{"type":"number"},"locked":{"type":"boolean"}}}},"clips":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"assetId":{"type":["integer","null"]},"kind":{"enum":["media","caption"]},"trackId":{"type":"string"},"position":{"type":"number"},"start":{"type":"number"},"end":{"type":"number"},"properties":{"type":"object","additionalProperties":true},"effects":{"type":"array","items":{"type":"object","additionalProperties":true}},"caption":{"type":"object","additionalProperties":true}}}},"assets":{"type":"array","items":{"type":"object","required":["id","imported"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"},"mime":{"type":"string"},"imported":{"type":"boolean","description":"True once the native editor has imported this asset and clip.add can use it."}}}},"transitions":{"type":"array","items":{"type":"object","additionalProperties":true}},"captionPresets":{"type":"array","items":{"type":"object","additionalProperties":true}},"history":{"type":"object","properties":{"undo":{"type":"boolean"},"redo":{"type":"boolean"}}},"rendering":{"type":"boolean"},"export":{"type":"object","properties":{"state":{"type":["string","null"]},"requestId":{"type":["string","null"]},"progress":{"type":["number","null"]},"assetId":{"type":["integer","null"]},"contentUrl":{"type":"string"},"error":{"type":["string","null"]}}}}},"MediaReview":{"type":"object","required":["id","assetId","state","statusUrl"],"properties":{"id":{"type":"string","format":"uuid"},"assetId":{"type":"integer","minimum":1},"projectId":{"type":["integer","null"]},"state":{"enum":["queued","running","completed","failed","cancelled"]},"attempts":{"type":"integer"},"createdAt":{"type":["string","null"],"format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"statusUrl":{"type":"string"},"error":{"type":["object","null"]},"result":{"type":["object","null"],"properties":{"analysisVersion":{"type":"string"},"sourceSha256":{"type":"string"},"sourceAssetId":{"type":"integer","minimum":1},"sourceRevision":{"type":["string","null"]},"renderId":{"type":["string","null"]},"durationSeconds":{"type":"number"},"timeOrigin":{"type":"number"},"status":{"enum":["pass","warning","fail"]},"coverageComplete":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":true},"checks":{"type":"object","additionalProperties":true},"findings":{"type":"array","items":{"type":"object","additionalProperties":true}},"transcript":{"type":"object","additionalProperties":true},"artifacts":{"type":"array","items":{"type":"object","required":["name","mime","size","sha256","contentUrl"],"properties":{"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"integer","minimum":1},"sha256":{"type":"string"},"contentUrl":{"type":"string"},"timestamp":{"type":"number"},"timelineTimestamp":{"type":"number"}}}}}}}},"EditorRender":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"projectId":{"type":"integer","minimum":1},"revision":{"type":"string"},"kind":{"enum":["final","preview"]},"state":{"enum":["rendering","uploading","completed","failed"]},"settings":{"type":"object","additionalProperties":true},"snapshot":{"type":"object","additionalProperties":true},"assetId":{"type":["integer","null"]},"contentUrl":{"type":["string","null"]},"error":{"type":["object","string","null"]}}},"ProductionJob":{"type":"object","required":["id","kind","state","statusUrl"],"properties":{"id":{"type":"string","format":"uuid"},"kind":{"enum":["finish","archive","variant"]},"state":{"enum":["queued","running","completed","failed","cancelled"]},"projectId":{"type":["integer","null"]},"assetId":{"type":["integer","null"]},"attempts":{"type":"integer","minimum":1},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"]},"finishedAt":{"type":["string","null"]},"statusUrl":{"type":"string"},"result":{"type":["object","null"],"properties":{"sourceAssetId":{"type":"integer","minimum":1},"assetId":{"type":"integer","minimum":1},"contentUrl":{"type":"string"},"retention":{"enum":["30_days","permanent"]},"duckingApplied":{"type":"boolean"},"audio":{"type":"object","properties":{"status":{"enum":["pass","warning"]},"integratedLufs":{"type":"number"},"truePeakDbtp":{"type":"number"},"targetLufs":{"type":"number"},"maximumTruePeakDbtp":{"type":"number"},"intelligibility":{"const":"not_checked"}}},"operation":{"$ref":"#/components/schemas/EditorOperation"},"renderRequired":{"type":"boolean"}}},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Envelope":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"const":"1"}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}}}},"Error":{"type":"object","required":["error","meta"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}},"meta":{"type":"object"}}},"ApiKeyInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"expiresInDays":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["name"],"additionalProperties":false},"BrandInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":5000}},"required":["name"],"additionalProperties":false},"EditorCommandInput":{"type":"object","properties":{"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"command":{"oneOf":[{"type":"object","properties":{"action":{"type":"string","const":"track.add"},"name":{"type":"string","minLength":1,"maxLength":160},"number":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000}},"required":["action","name"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"track.update"},"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":160},"locked":{"type":"boolean"}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"track.delete"},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.add"},"assetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"default":0,"type":"number","minimum":0,"maximum":1800},"start":{"default":0,"type":"number","minimum":0,"maximum":3600},"end":{"type":"number","exclusiveMinimum":0,"maximum":3600},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}}},"required":["action","assetId","trackId","end"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.update"},"id":{"type":"string","minLength":1,"maxLength":80},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"start":{"type":"number","minimum":0,"maximum":3600},"end":{"type":"number","exclusiveMinimum":0,"maximum":3600},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.delete"},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.split"},"id":{"type":"string","minLength":1,"maxLength":80},"at":{"type":"number","minimum":0,"maximum":1800}},"required":["action","id","at"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"clip.duplicate"},"id":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"trackId":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"effect.add"},"clipId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}},"maskAssetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"transitionId":{"type":"string","maxLength":250}},"required":["action","clipId","type"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"effect.update"},"clipId":{"type":"string","minLength":1,"maxLength":80},"id":{"type":"string","minLength":1,"maxLength":80},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}},"maskAssetId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"transitionId":{"type":"string","maxLength":250}},"required":["action","clipId","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"effect.delete"},"clipId":{"type":"string","minLength":1,"maxLength":80},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","clipId","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transition.add"},"transitionId":{"type":"string","minLength":1,"maxLength":250},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"reverse":{"default":false,"type":"boolean"}},"required":["action","transitionId","trackId","position","duration"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transition.update"},"id":{"type":"string","minLength":1,"maxLength":80},"trackId":{"type":"string","minLength":1,"maxLength":80},"position":{"type":"number","minimum":0,"maximum":1800},"start":{"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","minimum":0,"maximum":1800},"properties":{"type":"object","propertyNames":{"type":"string","maxLength":100},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"boolean"},{"type":"string","maxLength":30000},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":36000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":1,"maximum":216001},"value":{"type":"number"},"interpolation":{"default":"linear","type":"string","enum":["linear","bezier","constant"]},"left":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"right":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false}},"required":["frame","value"],"additionalProperties":false}}},"required":["keyframes"],"additionalProperties":false}]}}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transition.delete"},"id":{"type":"string","minLength":1,"maxLength":80}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.add"},"text":{"type":"string","minLength":1,"maxLength":2000},"position":{"type":"number","minimum":0,"maximum":1800},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","text","position","duration"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.update"},"id":{"type":"string","minLength":1,"maxLength":80},"text":{"type":"string","minLength":1,"maxLength":2000},"position":{"type":"number","minimum":0,"maximum":1800},"duration":{"type":"number","exclusiveMinimum":0,"maximum":1800},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","id"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.import"},"text":{"type":"string","minLength":1,"maxLength":300000},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","text"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.styleAll"},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","format"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"caption.preset"},"name":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"object","properties":{"role":{"type":"string","enum":["subtitle","title","brand","contact","disclosure"]},"style":{"type":"string","maxLength":80},"animation":{"type":"string","enum":["none","fade","pop","bounce","rise","slide"]},"placement":{"type":"string","enum":["top","center","bottom"]},"size":{"type":"number","minimum":0.1,"maximum":5},"scale_y":{"type":"number","minimum":0.1,"maximum":5},"offset_x":{"type":"number","minimum":-10000,"maximum":10000},"offset_y":{"type":"number","minimum":-10000,"maximum":10000},"rotation":{"type":"number","minimum":-360,"maximum":360},"clip_opacity":{"type":"number","minimum":0,"maximum":1},"appearance":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":160},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"additionalProperties":false}},"required":["action","name","format"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"profile.set"},"width":{"type":"integer","minimum":32,"maximum":3840},"height":{"type":"integer","minimum":32,"maximum":3840},"fps":{"type":"object","properties":{"num":{"type":"integer","minimum":1,"maximum":60000},"den":{"type":"integer","minimum":1,"maximum":1001}},"required":["num","den"],"additionalProperties":false}},"required":["action","width","height","fps"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"undo"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"redo"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"render"}},"required":["action"],"additionalProperties":false}]}},"required":["revision","command"],"additionalProperties":false},"EditorRenderInput":{"type":"object","properties":{"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["revision"],"additionalProperties":false},"ProjectInput":{"type":"object","properties":{"brandId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":120},"aspectRatio":{"default":"16:9","type":"string","enum":["16:9","9:16","1:1"]},"scenes":{"minItems":1,"maxItems":80,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","maxLength":120}},"required":["title"],"additionalProperties":false}}},"required":["name"],"additionalProperties":false},"SceneInput":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"default":"New scene","type":"string","maxLength":120}},"required":["id"],"additionalProperties":false},"GenerationInput":{"type":"object","properties":{"projectId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"sceneId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"modelKey":{"type":"string","minLength":1,"maxLength":120},"prompt":{"type":"string","minLength":1,"maxLength":30000},"references":{"default":[],"maxItems":30,"type":"array","items":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},{"type":"null"}]}},"settings":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":40},"additionalProperties":{"anyOf":[{"type":"string","maxLength":1000},{"type":"number"},{"type":"boolean"}]}},"parentGenerationId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647}},"required":["projectId","sceneId","modelKey","prompt"],"additionalProperties":false},"ExportInput":{"type":"object","properties":{"projectId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"clips":{"minItems":1,"maxItems":80,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"assetId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"start":{"type":"number","minimum":0,"maximum":1800},"end":{"type":"number","exclusiveMinimum":0,"maximum":1800},"transition":{"default":"cut","type":"string","enum":["cut","dissolve","fade-black","wipe-left","wipe-right","wipe-up","wipe-down","slide-left","slide-right","zoom-in"]},"transitionDuration":{"default":0.6,"type":"number","minimum":0.1,"maximum":2},"motion":{"default":"none","type":"string","enum":["none","zoom-in","zoom-out","pan-left","pan-right","rise","rotate-in","pulse"]},"fit":{"default":"contain","type":"string","enum":["contain","cover"]},"look":{"default":"none","type":"string","enum":["none","warm","cool","mono"]},"title":{"default":"","type":"string","maxLength":160},"titlePosition":{"default":"bottom","type":"string","enum":["top","center","bottom"]},"volume":{"default":1,"type":"number","minimum":0,"maximum":1}},"required":["assetId","start","end"]}}},"required":["projectId","clips"],"additionalProperties":false},"LinkInput":{"type":"object","properties":{"assetIds":{"minItems":1,"maxItems":80,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647}}},"required":["assetIds"],"additionalProperties":false},"Inline0":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":100000},"name":{"type":"string","minLength":1,"maxLength":120},"brandId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"slots":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z][a-zA-Z0-9_]{0,39}$"},"additionalProperties":{"type":"object","properties":{"type":{"type":"string","enum":["text","number","asset","color"]},"default":{"anyOf":[{"type":"string","maxLength":2000},{"type":"number"}]},"choices":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"string","maxLength":2000},{"type":"number"}]}}},"required":["type","default"],"additionalProperties":false}},"commands":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/Inline0/$defs/__schema0"}}}},"required":["id","version","name","slots","commands"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/Inline0/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/Inline0/$defs/__schema0"}}]}}}}}}