Server definition
- Hash
- sha256:31c7ffe4e5a2afb1eac4919216894d52e06bc008c202082c2dc3bbfc93d562b2
- What it is
- What a remote MCP server returned when asked what it offers: 122 tools
The blob, as servednamed by its sha256
{
"instructions": "BlitzReels exposes video project, media, timeline, caption, generation, and export operations. Authenticated operations require OAuth.",
"tools": [
{
"description": "Add an opening title card (hook) or generic text overlay to a project timeline. Defaults to classic white: black text on a white card.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"default": 4,
"exclusiveMinimum": 0,
"maximum": 3600,
"minimum": 0,
"type": "number"
},
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"kind": {
"default": "title_card",
"description": "title_card is an opening hook. overlay is generic on-video text.",
"enum": [
"overlay",
"title_card"
],
"type": "string"
},
"layerIndex": {
"minimum": 0,
"type": "integer"
},
"name": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"size": {
"default": "default",
"description": "Title-card size. Ignored for overlay.",
"enum": [
"compact",
"default",
"bold"
],
"type": "string"
},
"startSeconds": {
"default": 0,
"minimum": 0,
"type": "number"
},
"text": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"theme": {
"default": "classic_white",
"description": "Title-card look. classic_white is black text on a white card. Ignored for overlay.",
"enum": [
"classic_white",
"legend_white",
"white_black_outline",
"stacked_black_white",
"red_on_black",
"black_on_yellow",
"red_block"
],
"type": "string"
}
},
"required": [
"projectId",
"text",
"idempotencyKey"
],
"type": "object"
},
"name": "add_text_overlay",
"outputSchema": {
"additionalProperties": false,
"properties": {
"affectedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"baseRevision": {
"type": "integer"
},
"createdTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"deletedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"operationId": {
"type": "string"
},
"projectId": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"type": "object"
},
"revision": {
"type": "integer"
},
"txid": {
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"operationId",
"projectId",
"baseRevision",
"revision",
"replayed",
"txid",
"affectedTimelineItemIds",
"createdTimelineItemIds",
"deletedTimelineItemIds",
"warnings",
"result",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Add a timed transition effect, optionally attached to one timeline item and paired with sound.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"default": 0.6,
"exclusiveMinimum": 0,
"maximum": 10,
"minimum": 0,
"type": "number"
},
"easing": {
"default": "easeInOut",
"enum": [
"linear",
"easeIn",
"easeOut",
"easeInOut"
],
"type": "string"
},
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"includeSfx": {
"default": false,
"type": "boolean"
},
"intensity": {
"default": 0.5,
"maximum": 2,
"minimum": 0.2,
"type": "number"
},
"layerIndex": {
"minimum": 0,
"type": "integer"
},
"name": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"preset": {
"default": "flash",
"enum": [
"flash",
"film-flash",
"whip-left",
"whip-right",
"zoom-punch",
"glitch"
],
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"projectId",
"startSeconds",
"idempotencyKey"
],
"type": "object"
},
"name": "add_transition",
"outputSchema": {
"additionalProperties": false,
"properties": {
"affectedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"baseRevision": {
"type": "integer"
},
"createdTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"deletedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"operationId": {
"type": "string"
},
"projectId": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"type": "object"
},
"revision": {
"type": "integer"
},
"txid": {
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"operationId",
"projectId",
"baseRevision",
"revision",
"replayed",
"txid",
"affectedTimelineItemIds",
"createdTimelineItemIds",
"deletedTimelineItemIds",
"warnings",
"result",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Update timing, trim, layer, or state for up to 100 timeline items in one sequence transaction.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"updates": {
"description": "Each update needs at least one field to change besides timelineItemId.",
"items": {
"additionalProperties": false,
"properties": {
"blurredBackground": {
"type": "boolean"
},
"durationSeconds": {
"exclusiveMinimum": 0,
"type": "number"
},
"ignored": {
"type": "boolean"
},
"layerIndex": {
"minimum": 0,
"type": "integer"
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
},
"trimEndSeconds": {
"minimum": 0,
"type": "number"
},
"trimStartSeconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"timelineItemId"
],
"type": "object"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
}
},
"required": [
"projectId",
"updates",
"idempotencyKey"
],
"type": "object"
},
"name": "batch_update_timeline_clips",
"outputSchema": {
"additionalProperties": false,
"properties": {
"affectedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"baseRevision": {
"type": "integer"
},
"createdTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"deletedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"operationId": {
"type": "string"
},
"projectId": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"type": "object"
},
"revision": {
"type": "integer"
},
"txid": {
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"operationId",
"projectId",
"baseRevision",
"revision",
"replayed",
"txid",
"affectedTimelineItemIds",
"createdTimelineItemIds",
"deletedTimelineItemIds",
"warnings",
"result",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Apply a verified caption look to one project. Preserves word overrides unless clearWordOverrides=true. Existing captions are restyled; spoken audio is preserved.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"clearWordOverrides": {
"default": false,
"type": "boolean"
},
"idempotencyKey": {
"default": null,
"type": [
"string",
"null"
]
},
"lookId": {
"default": null,
"type": [
"string",
"null"
]
},
"projectId": {
"default": null,
"description": "UUID string.",
"format": "uuid",
"type": [
"string",
"null"
]
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"projectId",
"lookId",
"idempotencyKey"
],
"type": "object"
},
"name": "captions_look_apply",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Restore editable project captions from the selected source's completed canonical transcript. Keeps the full recording and avoids duplicate captions on identical retries. Requires source transcription first; no-speech is an explicit successful state.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID 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)$",
"type": "string"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"projectId",
"assetId"
],
"type": "object"
},
"name": "captions_source_prepare",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List built-in caption looks and saved caption themes available to a workspace.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"includeBuiltInLooks": {
"default": true,
"description": "Include built-in caption looks.",
"type": "boolean"
},
"includeSavedThemes": {
"default": true,
"description": "Include saved workspace caption themes.",
"type": "boolean"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "captions_themes_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"themes": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"themes"
],
"type": "object"
}
},
{
"description": "Replace selected caption words by their stable IDs. Preserves timing and the other captions; this does not change the spoken audio.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"updates": {
"items": {
"additionalProperties": false,
"properties": {
"text": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"wordId": {
"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)$",
"type": "string"
}
},
"required": [
"wordId",
"text"
],
"type": "object"
},
"maxItems": 200,
"minItems": 1,
"type": "array"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"projectId",
"updates"
],
"type": "object"
},
"name": "captions_words_correct",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read bounded editable caption words and stable word IDs for one project, optionally matching text.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 100,
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"matchText": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"projectId",
"matchText",
"limit",
"offset"
],
"type": "object"
},
"name": "captions_words_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Duplicate a carousel onto a new project. Copies slots. Icon and shot values may be pack filenames or asset:<media_asset_id>.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"idempotencyKey",
"projectId"
],
"type": "object"
},
"name": "carousels_clone",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_undo": {
"type": "boolean"
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"kit": {
"additionalProperties": false,
"properties": {
"active_theme_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"template_id",
"slots"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"background": {
"default": "",
"maxLength": 32,
"type": "string"
},
"bodyColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"fontFamily": {
"default": "",
"maxLength": 80,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"overlayEnabled": {
"type": "boolean"
},
"overlayOpacity": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"pageColor": {
"default": "",
"maxLength": 32,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"titleColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"fontFamily",
"titleColor",
"bodyColor",
"background",
"pageColor",
"overlayEnabled",
"overlayOpacity"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
}
},
"required": [
"themes",
"templates",
"active_theme_id"
],
"type": "object"
},
"locale": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout": {
"anyOf": [
{
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"photo_url": {
"anyOf": [
{
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"slot_urls": {
"additionalProperties": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"index",
"role",
"lines",
"slots",
"layout",
"visual"
],
"type": "object"
},
"type": "array"
},
"style": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"family": {
"enum": [
"photo",
"designed"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"label",
"family",
"slots"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Create or replace a carousel project from a slide document. Server owns chip layout, safezones, and exact export pixels.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"clear_existing": {
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"locale": {
"maxLength": 12,
"minLength": 2,
"type": "string"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"platform": {
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
"project_id": {
"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)$",
"type": "string"
},
"series_id": {
"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)$",
"type": "string"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"layout": {
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
"layout_overrides": {
"additionalProperties": false,
"properties": {
"top_px": {
"maximum": 1920,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"lines": {
"default": [],
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 6,
"type": "array"
},
"role": {
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"lines",
"visual"
],
"type": "object"
},
"maxItems": 35,
"minItems": 1,
"type": "array"
},
"style": {
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"platform",
"name",
"slides",
"idempotencyKey"
],
"type": "object"
},
"name": "carousels_compile",
"outputSchema": {
"additionalProperties": false,
"properties": {
"ai_image_run_id": {
"type": [
"string",
"null"
]
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"job_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slide_count": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"chip_band_px": {
"additionalProperties": false,
"properties": {
"bottom": {
"type": "number"
},
"top": {
"type": "number"
}
},
"required": [
"top",
"bottom"
],
"type": "object"
},
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout_applied": {
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
"overlay_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"timeline_item_ids": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"index",
"role",
"timeline_item_ids",
"overlay_ids",
"layout_applied",
"chip_band_px"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"project_id",
"revision",
"platform",
"slide_count",
"slides",
"frame",
"warnings",
"next_actions",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Turn a named recipe or a brief into compile-ready named-template slides. Expand never publishes and never invents metrics.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"audience": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"brief": {
"maxLength": 8000,
"minLength": 1,
"type": "string"
},
"locale": {
"maxLength": 12,
"minLength": 2,
"type": "string"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"offer": {
"maxLength": 400,
"minLength": 1,
"type": "string"
},
"platform": {
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
"product": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"recipeId": {
"enum": [
"curiosity_gap_ugc_7",
"result_first_demo_6",
"myth_guillotine_8",
"before_after_5",
"from_brief"
],
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"recipeId"
],
"type": "object"
},
"name": "carousels_expand_recipe",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"locale": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"platform": {
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
"recipe_id": {
"enum": [
"curiosity_gap_ugc_7",
"result_first_demo_6",
"myth_guillotine_8",
"before_after_5",
"from_brief"
],
"type": "string"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"layout": {
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
"layout_overrides": {
"additionalProperties": false,
"properties": {
"top_px": {
"maximum": 1920,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"lines": {
"default": [],
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 6,
"type": "array"
},
"role": {
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"lines",
"visual"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"recipe_id",
"name",
"platform",
"slides"
],
"type": "object"
}
},
{
"description": "Read the carousel slot document and the named template catalog.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "carousels_get",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"can_undo": {
"type": "boolean"
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"kit": {
"additionalProperties": false,
"properties": {
"active_theme_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"template_id",
"slots"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"background": {
"default": "",
"maxLength": 32,
"type": "string"
},
"bodyColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"fontFamily": {
"default": "",
"maxLength": 80,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"overlayEnabled": {
"type": "boolean"
},
"overlayOpacity": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"pageColor": {
"default": "",
"maxLength": 32,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"titleColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"fontFamily",
"titleColor",
"bodyColor",
"background",
"pageColor",
"overlayEnabled",
"overlayOpacity"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
}
},
"required": [
"themes",
"templates",
"active_theme_id"
],
"type": "object"
},
"locale": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout": {
"anyOf": [
{
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"photo_url": {
"anyOf": [
{
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"slot_urls": {
"additionalProperties": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"index",
"role",
"lines",
"slots",
"layout",
"visual"
],
"type": "object"
},
"type": "array"
},
"style": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"family": {
"enum": [
"photo",
"designed"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"label",
"family",
"slots"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"project_id",
"revision",
"name",
"platform",
"locale",
"frame",
"style",
"slides",
"templates",
"can_undo",
"warnings",
"next_actions"
],
"type": "object"
}
},
{
"description": "Save or apply a theme, brand theme, or named slide template. Themes rewrite fonts, colors, overlay, and asset:<id> logos. Never persist signed URLs.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"op": {
"enum": [
"save_theme",
"apply_theme",
"delete_theme",
"save_template",
"apply_template",
"delete_template",
"apply_brand"
],
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"savedTemplateId": {
"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)$",
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slideIndex": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"themeId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"idempotencyKey",
"projectId",
"op"
],
"type": "object"
},
"name": "carousels_kit",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_undo": {
"type": "boolean"
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"kit": {
"additionalProperties": false,
"properties": {
"active_theme_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"template_id",
"slots"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"background": {
"default": "",
"maxLength": 32,
"type": "string"
},
"bodyColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"fontFamily": {
"default": "",
"maxLength": 80,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"overlayEnabled": {
"type": "boolean"
},
"overlayOpacity": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"pageColor": {
"default": "",
"maxLength": 32,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"titleColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"fontFamily",
"titleColor",
"bodyColor",
"background",
"pageColor",
"overlayEnabled",
"overlayOpacity"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
}
},
"required": [
"themes",
"templates",
"active_theme_id"
],
"type": "object"
},
"locale": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout": {
"anyOf": [
{
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"photo_url": {
"anyOf": [
{
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"slot_urls": {
"additionalProperties": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"index",
"role",
"lines",
"slots",
"layout",
"visual"
],
"type": "object"
},
"type": "array"
},
"style": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"family": {
"enum": [
"photo",
"designed"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"label",
"family",
"slots"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Rebuild a compile slot document from a legacy overlay carousel. Then patch slots like any compiled deck.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"idempotencyKey",
"projectId"
],
"type": "object"
},
"name": "carousels_migrate",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_undo": {
"type": "boolean"
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"kit": {
"additionalProperties": false,
"properties": {
"active_theme_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"template_id",
"slots"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"background": {
"default": "",
"maxLength": 32,
"type": "string"
},
"bodyColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"fontFamily": {
"default": "",
"maxLength": 80,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"overlayEnabled": {
"type": "boolean"
},
"overlayOpacity": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"pageColor": {
"default": "",
"maxLength": 32,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"titleColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"fontFamily",
"titleColor",
"bodyColor",
"background",
"pageColor",
"overlayEnabled",
"overlayOpacity"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
}
},
"required": [
"themes",
"templates",
"active_theme_id"
],
"type": "object"
},
"locale": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout": {
"anyOf": [
{
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"photo_url": {
"anyOf": [
{
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"slot_urls": {
"additionalProperties": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"index",
"role",
"lines",
"slots",
"layout",
"visual"
],
"type": "object"
},
"type": "array"
},
"style": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"family": {
"enum": [
"photo",
"designed"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"label",
"family",
"slots"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Reorder, remove, insert, duplicate, or undo slides on a compiled carousel. One write for the filmstrip. Insert rasters an empty named template unless sourceIndex copies a slide.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"from": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"index": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"op": {
"enum": [
"reorder",
"remove",
"insert",
"undo"
],
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"sourceIndex": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"templateId": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"to": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"idempotencyKey",
"projectId",
"op"
],
"type": "object"
},
"name": "carousels_patch_document",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_undo": {
"type": "boolean"
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"kit": {
"additionalProperties": false,
"properties": {
"active_theme_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"template_id",
"slots"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"background": {
"default": "",
"maxLength": 32,
"type": "string"
},
"bodyColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"fontFamily": {
"default": "",
"maxLength": 80,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"overlayEnabled": {
"type": "boolean"
},
"overlayOpacity": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"pageColor": {
"default": "",
"maxLength": 32,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"titleColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"fontFamily",
"titleColor",
"bodyColor",
"background",
"pageColor",
"overlayEnabled",
"overlayOpacity"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
}
},
"required": [
"themes",
"templates",
"active_theme_id"
],
"type": "object"
},
"locale": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout": {
"anyOf": [
{
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"photo_url": {
"anyOf": [
{
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"slot_urls": {
"additionalProperties": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"index",
"role",
"lines",
"slots",
"layout",
"visual"
],
"type": "object"
},
"type": "array"
},
"style": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"family": {
"enum": [
"photo",
"designed"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"label",
"family",
"slots"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Patch named slots or template_id on one slide. Re-rasters that slide only. Never rewrite HTML.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"lines": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 6,
"type": "array"
},
"mediaAssetId": {
"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)$",
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"slideIndex": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"slots": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"templateId": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"idempotencyKey",
"projectId",
"slideIndex"
],
"type": "object"
},
"name": "carousels_patch_slide",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_undo": {
"type": "boolean"
},
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"kit": {
"additionalProperties": false,
"properties": {
"active_theme_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"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)$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"template_id",
"slots"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"background": {
"default": "",
"maxLength": 32,
"type": "string"
},
"bodyColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"fontFamily": {
"default": "",
"maxLength": 80,
"type": "string"
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"overlayEnabled": {
"type": "boolean"
},
"overlayOpacity": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"pageColor": {
"default": "",
"maxLength": 32,
"type": "string"
},
"scope": {
"enum": [
"project",
"brand"
],
"type": "string"
},
"titleColor": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
}
},
"required": [
"id",
"name",
"scope",
"fontFamily",
"titleColor",
"bodyColor",
"background",
"pageColor",
"overlayEnabled",
"overlayOpacity"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
}
},
"required": [
"themes",
"templates",
"active_theme_id"
],
"type": "object"
},
"locale": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"layout": {
"anyOf": [
{
"enum": [
"chip_stack_ui",
"chip_stack_face_safe",
"chip_stack_top",
"title_body_card"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"photo_url": {
"anyOf": [
{
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"enum": [
"hook",
"body",
"proof",
"cta"
],
"type": "string"
},
{
"type": "null"
}
]
},
"slot_urls": {
"additionalProperties": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"type": "object"
},
"visual": {
"additionalProperties": false,
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"colors": {
"items": {
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"html": {
"maxLength": 80000,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"media_asset",
"generate",
"solid",
"gradient",
"html",
"template"
],
"type": "string"
},
"media_asset_id": {
"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)$",
"type": "string"
},
"model_id": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"prompt": {
"maxLength": 1000,
"minLength": 3,
"type": "string"
},
"source_media_asset_id": {
"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)$",
"type": "string"
},
"template_id": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
}
},
"required": [
"index",
"role",
"lines",
"slots",
"layout",
"visual"
],
"type": "object"
},
"type": "array"
},
"style": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"chip": {
"additionalProperties": false,
"properties": {
"background": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"color": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"font_family": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"font_size": {
"maximum": 120,
"minimum": 12,
"type": "integer"
},
"font_weight": {
"anyOf": [
{
"maximum": 900,
"minimum": 100,
"type": "integer"
},
{
"type": "string"
}
]
},
"max_lines_per_chip": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"padding_x": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"padding_y": {
"maximum": 80,
"minimum": 0,
"type": "integer"
},
"radius": {
"maximum": 48,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"templates": {
"items": {
"additionalProperties": false,
"properties": {
"family": {
"enum": [
"photo",
"designed"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"label",
"family",
"slots"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Render JPEG stills for a compiled carousel at the exact platform frame and return them as MCP images so you can inspect chips on the real slides.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"chrome": {
"default": "none",
"enum": [
"tiktok",
"instagram",
"none"
],
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"slideIndexes": {
"items": {
"maximum": 34,
"minimum": 0,
"type": "integer"
},
"maxItems": 35,
"type": "array"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"projectId",
"chrome"
],
"type": "object"
},
"name": "carousels_preview",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"frame": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"width",
"height",
"aspect_ratio"
],
"type": "object"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"method",
"path",
"reason"
],
"type": "object"
},
"type": "array"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok_photo",
"instagram_4x5",
"linkedin"
],
"type": "string"
},
{
"type": "null"
}
]
},
"project_id": {
"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)$",
"type": "string"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"slides": {
"items": {
"additionalProperties": false,
"properties": {
"expires_at": {
"type": "string"
},
"height": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"index": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"preview_url": {
"type": "string"
},
"print": {
"enum": [
"slots",
"ingested"
],
"type": "string"
},
"width": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"index",
"preview_url",
"width",
"height",
"expires_at"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
},
"repair": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"project_id",
"revision",
"platform",
"frame",
"slides",
"warnings",
"next_actions"
],
"type": "object"
}
},
{
"description": "Create or update a reference-based character for repeatable faceless story generation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"canonicalDescription": {
"type": "string"
},
"characterId": {
"type": "string"
},
"confirmLikenessConsent": {
"default": false,
"description": "For a human character, set true only after the user confirms consent to use the depicted person's likeness.",
"type": "boolean"
},
"confirmRightsToReferences": {
"default": false,
"description": "Set true only after the user confirms they own the reference media or have permission to use it.",
"type": "boolean"
},
"defaultVoiceId": {
"type": "string"
},
"defaultVoiceStyle": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"name": {
"type": "string"
},
"primaryReferenceAssetId": {
"type": "string"
},
"referenceAssetIds": {
"items": {
"type": "string"
},
"type": "array"
},
"species": {
"type": "string"
},
"storyFacts": {
"items": {
"type": "string"
},
"type": "array"
},
"type": {
"default": "human",
"enum": [
"human",
"fictional",
"other"
],
"type": "string"
},
"workspaceId": {
"description": "Optional workspace UUID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"name",
"idempotencyKey"
],
"type": "object"
},
"name": "characters_apply",
"outputSchema": {
"additionalProperties": false,
"properties": {
"character": {
"type": "object"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
}
},
"required": [
"character",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Inspect one reusable character and its ordered reference-image set before planning a story.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"characterId": {
"type": "string"
},
"workspaceId": {
"description": "Optional workspace UUID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"characterId"
],
"type": "object"
},
"name": "characters_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"character": {
"type": "object"
}
},
"required": [
"character"
],
"type": "object"
}
},
{
"description": "List bounded reusable characters with identity, voice, facts, and image-reference metadata.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"includeArchived": {
"default": false,
"type": "boolean"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "number"
},
"offset": {
"default": 0,
"minimum": 0,
"type": "number"
},
"workspaceId": {
"description": "Optional workspace UUID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "characters_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"characters": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"characters",
"bounds"
],
"type": "object"
}
},
{
"description": "Preview or delete a terminal clip batch. Dry-run is the default; real deletion requires explicit confirmation, retention choice, workspace delete permission, and an idempotency key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"batchId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"confirmDelete": {
"default": false,
"type": "boolean"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 255,
"minLength": 8,
"type": "string"
},
"retention": {
"default": "retain_projects_and_exports",
"enum": [
"retain_projects_and_exports",
"delete_projects_and_exports"
],
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"batchId",
"idempotencyKey"
],
"type": "object"
},
"name": "clip_batches_delete",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read whether the source video's clip share page is public and which clips are visible. Does not publish content.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"assetId"
],
"type": "object"
},
"name": "clip_share_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Make the selected source video's clip page public with reviewed title, description and explicit download permission. Requires confirmPublicSharing=true from the user. Returns the verified public URL; no social network post is made.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"allowDownloads": {
"type": "boolean"
},
"assetId": {
"description": "UUID 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)$",
"type": "string"
},
"confirmPublicSharing": {
"const": true,
"type": "boolean"
},
"description": {
"default": "",
"maxLength": 500,
"type": "string"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"title": {
"maxLength": 140,
"minLength": 1,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"assetId",
"title",
"description",
"allowDownloads",
"confirmPublicSharing"
],
"type": "object"
},
"name": "clip_share_publish",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Disable public access to the selected clip page. Changes an existing publication; preserves private projects and exports.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID 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)$",
"type": "string"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"assetId"
],
"type": "object"
},
"name": "clip_share_unpublish",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Show or hide one identified clip on an existing public review page after explicit user confirmation. Preserves the other clips and private project data.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID 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)$",
"type": "string"
},
"clipId": {
"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)$",
"type": "string"
},
"confirmPublicSharing": {
"const": true,
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"visibility": {
"enum": [
"visible",
"hidden"
],
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"assetId",
"clipId",
"visibility",
"confirmPublicSharing"
],
"type": "object"
},
"name": "clip_share_visibility_set",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Read existing suggested moments with source ranges, hooks, transcript excerpts and thumbnails before producing videos. Results are bounded; this does not generate suggestions or render clips.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID 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)$",
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"assetId",
"limit",
"offset"
],
"type": "object"
},
"name": "clips_candidates_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Create a private BlitzReels clip batch from an existing asset or a user-provided video URL. Supports public social videos, Google Drive, and direct media URLs.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "Existing BlitzReels video asset ID. Provide assetId or url, not both. UUID string.",
"format": "uuid",
"type": "string"
},
"autoTrimSilence": {
"default": true,
"description": "Trim silence around selected moments.",
"type": "boolean"
},
"captionThemeId": {
"description": "Saved theme UUID or built-in caption look. Omitted inherits Series defaults; null uses workspace captions.",
"type": "string"
},
"clipCount": {
"description": "Maximum clips requested. Available source moments and account limits can yield fewer.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"clipPresetId": {
"default": "default",
"description": "Clip style preset. Use high-retention for High Retention clips or demo-focus for product and screen demos.",
"enum": [
"default",
"high-retention",
"demo-focus"
],
"type": "string"
},
"createSharePage": {
"default": false,
"description": "Create a public showcase page where completed clips appear.",
"type": "boolean"
},
"durationBounds": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"maxSeconds": {
"maximum": 180,
"minimum": 1,
"type": [
"number",
"null"
]
},
"minSeconds": {
"maximum": 180,
"minimum": 1,
"type": [
"number",
"null"
]
}
},
"required": [
"minSeconds",
"maxSeconds"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Requested clip duration bounds. Selection preserves complete moments; minimum cannot exceed maximum."
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"type": "string"
},
"selectedAudioLanguage": {
"description": "Audio language track for a social-video URL, using the language reported by media_import_inspect. Null uses source default. Existing assets and direct files preserve source audio.",
"maxLength": 40,
"minLength": 2,
"type": "string"
},
"selection": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"excludeIds": {
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array",
"uniqueItems": true
},
"includeIds": {
"anyOf": [
{
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
{
"type": "null"
}
]
}
},
"required": [
"includeIds",
"excludeIds"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Existing asset only: reviewed candidate IDs to include in order or exclude. Resolve IDs with clips_candidates_list first. Null delegates selection."
},
"seriesId": {
"description": "Optional Series UUID. Omitted inherits the source Series; null creates standalone clips.",
"type": "string"
},
"url": {
"description": "Video URL to import before clipping. Supports social video links, Google Drive file links, and direct video file URLs.",
"format": "uri",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "clips_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"batch": {
"additionalProperties": false,
"properties": {
"assetId": {
"type": "string"
},
"clipPreset": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"clips": {
"items": {
"additionalProperties": false,
"properties": {
"downloadUrl": {
"type": [
"string",
"null"
]
},
"errorMessage": {
"type": [
"string",
"null"
]
},
"exportId": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"projectId": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"suggestionId": {
"type": [
"string",
"null"
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"id",
"suggestionId",
"projectId",
"exportId",
"title",
"status",
"downloadUrl",
"thumbnailUrl",
"errorMessage"
],
"type": "object"
},
"type": "array"
},
"downloadUrlExpiresInSeconds": {
"type": "number"
},
"estimatedClipCount": {
"type": "number"
},
"failedCount": {
"type": "number"
},
"id": {
"type": "string"
},
"lastErrorMessage": {
"type": [
"string",
"null"
]
},
"polling": {
"additionalProperties": false,
"properties": {
"isTerminal": {
"type": "boolean"
},
"maxPollAttempts": {
"type": "number"
},
"maxPollSeconds": {
"type": "number"
},
"nextPollAfterSeconds": {
"type": [
"number",
"null"
]
},
"shouldPoll": {
"type": "boolean"
},
"stage": {
"type": "string"
},
"state": {
"type": "string"
},
"suggestedTool": {
"enum": [
"clips_get",
"clips_status_get"
],
"type": "string"
}
},
"required": [
"state",
"stage",
"isTerminal",
"shouldPoll",
"suggestedTool",
"nextPollAfterSeconds",
"maxPollSeconds",
"maxPollAttempts"
],
"type": "object"
},
"projectFolderId": {
"type": [
"string",
"null"
]
},
"projectFolderUrl": {
"type": [
"string",
"null"
]
},
"renderedCount": {
"type": "number"
},
"reviewCount": {
"type": "number"
},
"selectedQuality": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": "string"
},
"status": {
"type": "string"
},
"studioUrl": {
"type": "string"
},
"totalClipCount": {
"type": "number"
},
"zipDownloadUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"status",
"assetId",
"projectFolderId",
"estimatedClipCount",
"totalClipCount",
"renderedCount",
"failedCount",
"reviewCount",
"clipPreset",
"selectedQuality",
"lastErrorMessage",
"sourceUrl",
"studioUrl",
"projectFolderUrl",
"zipDownloadUrl",
"downloadUrlExpiresInSeconds",
"polling",
"clips"
],
"type": "object"
},
"result": {
"additionalProperties": false,
"properties": {
"batch": {
"additionalProperties": false,
"properties": {
"assetId": {
"type": "string"
},
"clipPreset": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"clips": {
"items": {
"additionalProperties": false,
"properties": {
"downloadUrl": {
"type": [
"string",
"null"
]
},
"errorMessage": {
"type": [
"string",
"null"
]
},
"exportId": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"projectId": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"suggestionId": {
"type": [
"string",
"null"
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"id",
"suggestionId",
"projectId",
"exportId",
"title",
"status",
"downloadUrl",
"thumbnailUrl",
"errorMessage"
],
"type": "object"
},
"type": "array"
},
"downloadUrlExpiresInSeconds": {
"type": "number"
},
"estimatedClipCount": {
"type": "number"
},
"failedCount": {
"type": "number"
},
"id": {
"type": "string"
},
"lastErrorMessage": {
"type": [
"string",
"null"
]
},
"polling": {
"additionalProperties": false,
"properties": {
"isTerminal": {
"type": "boolean"
},
"maxPollAttempts": {
"type": "number"
},
"maxPollSeconds": {
"type": "number"
},
"nextPollAfterSeconds": {
"type": [
"number",
"null"
]
},
"shouldPoll": {
"type": "boolean"
},
"stage": {
"type": "string"
},
"state": {
"type": "string"
},
"suggestedTool": {
"enum": [
"clips_get",
"clips_status_get"
],
"type": "string"
}
},
"required": [
"state",
"stage",
"isTerminal",
"shouldPoll",
"suggestedTool",
"nextPollAfterSeconds",
"maxPollSeconds",
"maxPollAttempts"
],
"type": "object"
},
"projectFolderId": {
"type": [
"string",
"null"
]
},
"projectFolderUrl": {
"type": [
"string",
"null"
]
},
"renderedCount": {
"type": "number"
},
"reviewCount": {
"type": "number"
},
"selectedQuality": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": "string"
},
"status": {
"type": "string"
},
"studioUrl": {
"type": "string"
},
"totalClipCount": {
"type": "number"
},
"zipDownloadUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"status",
"assetId",
"projectFolderId",
"estimatedClipCount",
"totalClipCount",
"renderedCount",
"failedCount",
"reviewCount",
"clipPreset",
"selectedQuality",
"lastErrorMessage",
"sourceUrl",
"studioUrl",
"projectFolderUrl",
"zipDownloadUrl",
"downloadUrlExpiresInSeconds",
"polling",
"clips"
],
"type": "object"
},
"importedAssetId": {
"type": "string"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"sourceKind": {
"type": "string"
}
},
"required": [
"batch",
"importedAssetId",
"sourceKind",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"result",
"batch"
],
"type": "object"
}
},
{
"description": "Render one managed clip at an existing-account-supported quality. Returns persisted export state; inspect until the accepted delivery file is ready. Can spend existing account credits.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"clipId": {
"default": null,
"type": [
"string",
"null"
]
},
"coverFrameSeconds": {
"minimum": 0,
"type": "number"
},
"format": {
"default": "mp4",
"enum": [
"mp4",
"mov"
],
"type": "string"
},
"idempotencyKey": {
"default": null,
"type": [
"string",
"null"
]
},
"resolution": {
"default": "1080p",
"enum": [
"720p",
"1080p"
],
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"clipId",
"idempotencyKey"
],
"type": "object"
},
"name": "clips_export",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Get status, generated clips, render counts, and download links for a BlitzReels clip batch.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"batchId": {
"description": "Clip batch ID. UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"batchId"
],
"type": "object"
},
"name": "clips_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"batch": {
"additionalProperties": false,
"properties": {
"assetId": {
"type": "string"
},
"clipPreset": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"clips": {
"items": {
"additionalProperties": false,
"properties": {
"downloadUrl": {
"type": [
"string",
"null"
]
},
"errorMessage": {
"type": [
"string",
"null"
]
},
"exportId": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"projectId": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"suggestionId": {
"type": [
"string",
"null"
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"id",
"suggestionId",
"projectId",
"exportId",
"title",
"status",
"downloadUrl",
"thumbnailUrl",
"errorMessage"
],
"type": "object"
},
"type": "array"
},
"downloadUrlExpiresInSeconds": {
"type": "number"
},
"estimatedClipCount": {
"type": "number"
},
"failedCount": {
"type": "number"
},
"id": {
"type": "string"
},
"lastErrorMessage": {
"type": [
"string",
"null"
]
},
"polling": {
"additionalProperties": false,
"properties": {
"isTerminal": {
"type": "boolean"
},
"maxPollAttempts": {
"type": "number"
},
"maxPollSeconds": {
"type": "number"
},
"nextPollAfterSeconds": {
"type": [
"number",
"null"
]
},
"shouldPoll": {
"type": "boolean"
},
"stage": {
"type": "string"
},
"state": {
"type": "string"
},
"suggestedTool": {
"enum": [
"clips_get",
"clips_status_get"
],
"type": "string"
}
},
"required": [
"state",
"stage",
"isTerminal",
"shouldPoll",
"suggestedTool",
"nextPollAfterSeconds",
"maxPollSeconds",
"maxPollAttempts"
],
"type": "object"
},
"projectFolderId": {
"type": [
"string",
"null"
]
},
"projectFolderUrl": {
"type": [
"string",
"null"
]
},
"renderedCount": {
"type": "number"
},
"reviewCount": {
"type": "number"
},
"selectedQuality": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": "string"
},
"status": {
"type": "string"
},
"studioUrl": {
"type": "string"
},
"totalClipCount": {
"type": "number"
},
"zipDownloadUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"status",
"assetId",
"projectFolderId",
"estimatedClipCount",
"totalClipCount",
"renderedCount",
"failedCount",
"reviewCount",
"clipPreset",
"selectedQuality",
"lastErrorMessage",
"sourceUrl",
"studioUrl",
"projectFolderUrl",
"zipDownloadUrl",
"downloadUrlExpiresInSeconds",
"polling",
"clips"
],
"type": "object"
}
},
"required": [
"batch"
],
"type": "object"
}
},
{
"description": "Read one managed clip's selected source range, project, workflow state and delivery information.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"clipId": {
"default": null,
"type": [
"string",
"null"
]
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"clipId"
],
"type": "object"
},
"name": "clips_inspect",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List bounded managed clips from the selected source or project with their current workflow state.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "number"
},
"offset": {
"default": 0,
"minimum": 0,
"type": "number"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"status": {
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "clips_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List or inspect clips, regenerate, repair visual QA, start export, promote an accepted delivery export, inspect caption words, or apply a verified caption look.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"allowBlockingQaBypass": {
"default": false,
"type": "boolean"
},
"assetId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"captionWordLimit": {
"default": 100,
"maximum": 500,
"minimum": 1,
"type": "number"
},
"captionsEnabled": {
"type": "boolean"
},
"clearWordOverrides": {
"default": false,
"type": "boolean"
},
"clipId": {
"type": "string"
},
"confirmVisualQa": {
"default": false,
"type": "boolean"
},
"contentTypeHint": {
"enum": [
"auto",
"podcast",
"tutorial",
"demo",
"generic"
],
"type": "string"
},
"coverFrameSeconds": {
"minimum": 0,
"type": "number"
},
"endSeconds": {
"type": "number"
},
"exportId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"format": {
"default": "mp4",
"enum": [
"mp4",
"mov"
],
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"layoutMode": {
"enum": [
"auto",
"people_first",
"screen_first",
"preserve_full_source",
"prefer_split",
"prefer_focus",
"prefer_tutorial",
"prefer_demo"
],
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "number"
},
"lookId": {
"type": "string"
},
"matchText": {
"type": "string"
},
"maxDurationSeconds": {
"type": "number"
},
"minDurationSeconds": {
"type": "number"
},
"offset": {
"default": 0,
"minimum": 0,
"type": "number"
},
"operation": {
"enum": [
"list",
"get",
"reselect",
"repair",
"export",
"promote_export",
"list_caption_words",
"set_caption_look"
],
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"repairMode": {
"default": "auto",
"enum": [
"auto",
"prefer_split",
"prefer_focus",
"prefer_tutorial",
"prefer_demo",
"move_captions_off_faces"
],
"type": "string"
},
"resolution": {
"default": "1080p",
"enum": [
"720p",
"1080p"
],
"type": "string"
},
"selectionMode": {
"enum": [
"auto_best",
"suggestion",
"time_range"
],
"type": "string"
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"status": {
"type": "string"
},
"suggestionId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"timelineItemId": {
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"operation"
],
"type": "object"
},
"name": "clips_manage",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List available clip batch presets and their clipping/caption defaults.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "clips_presets_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"presets": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"presets"
],
"type": "object"
}
},
{
"description": "Recover a terminal batch's missing clip count through the persisted recovery workflow. Preserves accepted clips and returns the recovery batch ID. Can spend existing account credits; retry with the identical idempotency key.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"batchId": {
"description": "UUID 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)$",
"type": "string"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"targetClipCount": {
"anyOf": [
{
"maximum": 30,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"batchId",
"targetClipCount"
],
"type": "object"
},
"name": "clips_recover",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Request a layout repair for one managed clip, such as preserving a screen demo or moving captions away from faces. Changes that clip's project; preserves the other clips.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"clipId": {
"default": null,
"type": [
"string",
"null"
]
},
"idempotencyKey": {
"default": null,
"type": [
"string",
"null"
]
},
"repairMode": {
"default": "auto",
"enum": [
"auto",
"prefer_split",
"prefer_focus",
"prefer_tutorial",
"prefer_demo",
"move_captions_off_faces"
],
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"clipId",
"idempotencyKey"
],
"type": "object"
},
"name": "clips_repair",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Replace the source moment for one managed clip using a verified suggestion or explicit time range. Can spend existing account credits. Preserves the other clips; read current state before retrying.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"captionsEnabled": {
"type": "boolean"
},
"clipId": {
"default": null,
"type": [
"string",
"null"
]
},
"contentTypeHint": {
"enum": [
"auto",
"podcast",
"tutorial",
"demo",
"generic"
],
"type": "string"
},
"endSeconds": {
"type": "number"
},
"idempotencyKey": {
"default": null,
"type": [
"string",
"null"
]
},
"layoutMode": {
"enum": [
"auto",
"people_first",
"screen_first",
"preserve_full_source",
"prefer_split",
"prefer_focus",
"prefer_tutorial",
"prefer_demo"
],
"type": "string"
},
"lookId": {
"type": "string"
},
"maxDurationSeconds": {
"type": "number"
},
"minDurationSeconds": {
"type": "number"
},
"selectionMode": {
"default": null,
"enum": [
"auto_best",
"suggestion",
"time_range"
],
"type": [
"string",
"null"
]
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"suggestionId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"clipId",
"selectionMode",
"idempotencyKey"
],
"type": "object"
},
"name": "clips_reselect",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read one existing batch's progress, ready clips and renewed signed links without opening or remounting a review widget. Safe for bounded polling and widget refresh; does not recreate or repair clips.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"batchId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"batchId"
],
"type": "object"
},
"name": "clips_status_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"batch": {
"additionalProperties": false,
"properties": {
"assetId": {
"type": "string"
},
"clipPreset": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"clips": {
"items": {
"additionalProperties": false,
"properties": {
"downloadUrl": {
"type": [
"string",
"null"
]
},
"errorMessage": {
"type": [
"string",
"null"
]
},
"exportId": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"projectId": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"suggestionId": {
"type": [
"string",
"null"
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"id",
"suggestionId",
"projectId",
"exportId",
"title",
"status",
"downloadUrl",
"thumbnailUrl",
"errorMessage"
],
"type": "object"
},
"type": "array"
},
"downloadUrlExpiresInSeconds": {
"type": "number"
},
"estimatedClipCount": {
"type": "number"
},
"failedCount": {
"type": "number"
},
"id": {
"type": "string"
},
"lastErrorMessage": {
"type": [
"string",
"null"
]
},
"polling": {
"additionalProperties": false,
"properties": {
"isTerminal": {
"type": "boolean"
},
"maxPollAttempts": {
"type": "number"
},
"maxPollSeconds": {
"type": "number"
},
"nextPollAfterSeconds": {
"type": [
"number",
"null"
]
},
"shouldPoll": {
"type": "boolean"
},
"stage": {
"type": "string"
},
"state": {
"type": "string"
},
"suggestedTool": {
"enum": [
"clips_get",
"clips_status_get"
],
"type": "string"
}
},
"required": [
"state",
"stage",
"isTerminal",
"shouldPoll",
"suggestedTool",
"nextPollAfterSeconds",
"maxPollSeconds",
"maxPollAttempts"
],
"type": "object"
},
"projectFolderId": {
"type": [
"string",
"null"
]
},
"projectFolderUrl": {
"type": [
"string",
"null"
]
},
"renderedCount": {
"type": "number"
},
"reviewCount": {
"type": "number"
},
"selectedQuality": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": "string"
},
"status": {
"type": "string"
},
"studioUrl": {
"type": "string"
},
"totalClipCount": {
"type": "number"
},
"zipDownloadUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"status",
"assetId",
"projectFolderId",
"estimatedClipCount",
"totalClipCount",
"renderedCount",
"failedCount",
"reviewCount",
"clipPreset",
"selectedQuality",
"lastErrorMessage",
"sourceUrl",
"studioUrl",
"projectFolderUrl",
"zipDownloadUrl",
"downloadUrlExpiresInSeconds",
"polling",
"clips"
],
"type": "object"
}
},
"required": [
"batch"
],
"type": "object"
}
},
{
"description": "Read bounded existing provider-reported engagement in the selected workspace, sorted by views. Returns source title, caption, published date and views/likes/comments/shares/saves. Does not import new data, start monitoring or infer attributable leads, sales or revenue.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"platform": {
"default": "all",
"enum": [
"all",
"youtube",
"instagram",
"facebook",
"tiktok"
],
"type": "string"
},
"range": {
"default": "30d",
"enum": [
"7d",
"30d",
"90d",
"all"
],
"type": "string"
},
"search": {
"default": "",
"maxLength": 200,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"platform",
"range",
"limit",
"offset",
"search"
],
"type": "object"
},
"name": "content_performance_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Preview or delete up to 100 timeline items and optionally remove linked captions.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"confirmDelete": {
"default": false,
"type": "boolean"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"removeAssociatedCaptions": {
"default": true,
"type": "boolean"
},
"timelineItemIds": {
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
}
},
"required": [
"projectId",
"timelineItemIds"
],
"type": "object"
},
"name": "delete_timeline_items",
"outputSchema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"dryRun": {
"const": true,
"type": "boolean"
},
"plan": {
"type": "object"
}
},
"required": [
"dryRun",
"plan"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"dryRun": {
"const": false,
"type": "boolean"
},
"mutation": {
"additionalProperties": false,
"properties": {
"affectedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"baseRevision": {
"type": "integer"
},
"createdTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"deletedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"operationId": {
"type": "string"
},
"projectId": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"type": "object"
},
"revision": {
"type": "integer"
},
"txid": {
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"operationId",
"projectId",
"baseRevision",
"revision",
"replayed",
"txid",
"affectedTimelineItemIds",
"createdTimelineItemIds",
"deletedTimelineItemIds",
"warnings",
"result",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"dryRun",
"mutation"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Replace one shot's media asset while preserving the other timeline items. Revision checked; dryRun previews by default. Requires a current editor snapshot and an asset in the same workspace.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"itemId": {
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"itemId",
"assetId",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_asset_replace",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Insert a workspace image, generated shot or audio asset at an explicit project time. Revision checked; dryRun previews by default.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "UUID string.",
"format": "uuid",
"minLength": 1,
"type": "string"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"durationSeconds": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"layerIndex": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assetId",
"startSeconds",
"durationSeconds",
"layerIndex",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_assets_insert",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Adjust one item's volume and audio fades. Revision checked; dryRun previews by default. Preserves the rest of the project.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dryRun": {
"default": true,
"type": "boolean"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fadeInSeconds": {
"minimum": 0,
"type": "number"
},
"fadeOutSeconds": {
"minimum": 0,
"type": "number"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"itemId": {
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"volume": {
"maximum": 2,
"minimum": 0,
"type": "number"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"itemId",
"volume",
"fadeInSeconds",
"fadeOutSeconds",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_audio_set",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Adjust the crop of one existing source view after a layout has been applied. Revision checked; dryRun previews by default. Preserves the other shots.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"crop": {
"additionalProperties": false,
"properties": {
"height": {
"maximum": 1,
"minimum": 0.0001,
"type": "number"
},
"width": {
"maximum": 1,
"minimum": 0.0001,
"type": "number"
},
"x": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"y": {
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"x",
"y",
"width",
"height"
],
"type": "object"
},
"dryRun": {
"default": true,
"type": "boolean"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"itemId": {
"minLength": 1,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"itemId",
"crop",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_crop_set",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Restore one saved editor action at the expected current revision. Requires the action ID from edit history and an idempotency key. Existing project data is changed.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"actionId": {
"minLength": 1,
"type": "string"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"projectId",
"actionId",
"expectedRevision",
"workspaceId",
"idempotencyKey"
],
"type": "object"
},
"name": "editor_edit_undo",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read up to 50 saved edit actions, their labels and undo state. Does not restore or change the project.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"projectId",
"limit"
],
"type": "object"
},
"name": "editor_history_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Move selected timeline items to explicit times and layers. Revision checked; dryRun previews by default.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dryRun": {
"default": true,
"type": "boolean"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"minLength": 1,
"type": "string"
},
"layerIndex": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"startSeconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"id",
"startSeconds",
"layerIndex"
],
"type": "object"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"items",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_items_move",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Remove selected timeline items and, if requested, their linked captions. Revision checked; dryRun previews by default. The saved action can be undone.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dryRun": {
"default": true,
"type": "boolean"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"itemIds": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"removeAssociatedCaptions": {
"type": "boolean"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"itemIds",
"removeAssociatedCaptions",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_items_remove",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read the current revision, stable timeline IDs, captions, style and bounded media context before a precise revision. Signed media links are refreshed by reading again.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"expectedRevision": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"default": 100,
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"projectId",
"offset",
"limit",
"expectedRevision"
],
"type": "object"
},
"name": "editor_snapshot_get",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Create or revise one title or text overlay with explicit timing. Revision checked; dryRun previews by default. This edits project text, not spoken audio or captions.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dryRun": {
"default": true,
"type": "boolean"
},
"durationSeconds": {
"exclusiveMinimum": 0,
"minimum": 0,
"type": "number"
},
"expectedRevision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"itemId": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"spec": {
"anyOf": [
{
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"text": {
"minLength": 1,
"type": "string"
},
"textKind": {
"enum": [
"overlay",
"title_card"
],
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"itemId",
"text",
"textKind",
"spec",
"startSeconds",
"durationSeconds",
"workspaceId",
"idempotencyKey",
"projectId",
"expectedRevision",
"dryRun"
],
"type": "object"
},
"name": "editor_text_set",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read a WebVTT caption track from the completed export's immutable canonical speech snapshot, preserving the actual export trims. Returns unavailable for older exports or unverified speech; never fabricates captions from titles or current edited timelines.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"exportId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"exportId"
],
"type": "object"
},
"name": "exports_caption_track_get",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List exports with render status and progress. Completed exports include a signed download URL. Pass exportId to return one export.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"exportId": {
"description": "Return only this export, including its signed download URL when the render is complete. UUID string.",
"format": "uuid",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum exports to return when exportId is absent (1-50).",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"offset": {
"default": 0,
"description": "Export offset when exportId is absent.",
"minimum": 0,
"type": "number"
},
"projectId": {
"description": "Filter exports by project ID. UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "exports_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"exports": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"exports",
"bounds"
],
"type": "object"
}
},
{
"description": "Render a BlitzReels video project and return export and job IDs for status checks.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coverFrameSeconds": {
"description": "Optional cover thumbnail timestamp",
"minimum": 0,
"type": "number"
},
"format": {
"default": "mp4",
"description": "Export container format",
"enum": [
"mp4",
"mov",
"fcpxml"
],
"type": "string"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"type": "string"
},
"projectId": {
"description": "BlitzReels project ID. UUID string.",
"format": "uuid",
"type": "string"
},
"resolution": {
"default": "1080p",
"description": "Export resolution",
"enum": [
"720p",
"1080p",
"4k"
],
"type": "string"
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "exports_start",
"outputSchema": {
"additionalProperties": false,
"properties": {
"export": {
"properties": {
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
}
},
"required": [
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"export"
],
"type": "object"
}
},
{
"description": "Turn a script into a full faceless video project: scene plan, generated visuals, optional voiceover, captions, music, and sound. Spends AI credits and returns a job to poll with generation_jobs_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"captionStyleId": {
"description": "Optional caption theme ID from captions_themes_list.",
"maxLength": 200,
"type": "string"
},
"generateBackgroundMusic": {
"default": false,
"description": "Add a generated background track.",
"type": "boolean"
},
"generateSoundEffects": {
"default": false,
"description": "Add generated sound effects.",
"type": "boolean"
},
"generateVoiceover": {
"default": true,
"description": "Narrate the script with a generated voice.",
"type": "boolean"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"imageModelId": {
"default": "fal-ai/nano-banana-pro",
"description": "Model used to generate scene images.",
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"includeCaptions": {
"default": true,
"description": "Burn captions into the timeline.",
"type": "boolean"
},
"plannerModelId": {
"default": "google/gemini-3.8-flash",
"description": "Model used to plan the video scenes.",
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"projectName": {
"default": "Faceless Video",
"description": "Name for the created BlitzReels project.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"script": {
"description": "The narration or story to turn into a video.",
"maxLength": 30000,
"minLength": 1,
"type": "string"
},
"seriesId": {
"description": "Optional Series UUID. Inherits its Story Kit and branding defaults for this new video.",
"type": "string"
},
"storyKitId": {
"description": "Reusable Story Kit UUID for characters, references, locations, style, and narrator voice.",
"type": "string"
},
"styleReferenceAssetIds": {
"default": [],
"description": "Optional stills that lock rendering medium, palette, lighting and texture. Not used as scene frames.",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"targetDurationSeconds": {
"default": 45,
"description": "Target runtime between 10 and 120 seconds.",
"maximum": 120,
"minimum": 10,
"type": "number"
},
"videoModel": {
"default": "seedance-2.0-ref2v",
"description": "Image-to-video model used to animate scenes.",
"enum": [
"seedance-2.5-edit",
"kling-o3-standard-edit",
"kling-o3-pro-edit",
"kling-v3-standard-motion-control",
"kling-v3-pro-motion-control",
"wan-2.2-animate-replace",
"kling-2.1",
"kling-2.6-pro",
"kling-o1",
"kling-3.0",
"kling-o3-standard",
"kling-o3-pro",
"kling-o3-4k",
"kling-v3-pro",
"minimax-01",
"minimax-hailuo-02",
"minimax-hailuo-2.3-pro",
"minimax-h3-max",
"luma-ray-2",
"luma-ray-3.2",
"veo3",
"veo3.1",
"veo3.1-fast",
"gemini-omni-flash-ref2v",
"gemini-omni-flash-edit",
"gemini-omni-flash",
"wan-2.7",
"wan-2.7-ref2v",
"wan-3.0",
"happy-horse",
"happy-horse-ref2v",
"pixverse-v6",
"grok-imagine",
"seedance-2.0-pro",
"seedance-2.5",
"seedance-2.0-pro-fast",
"seedance-2.0-ref2v",
"seedance-2.0-ref2v-fast",
"seedance-1.5-pro",
"seedance-1.0-pro",
"seedance-1.0-pro-fast",
"seedance-1.0-lite",
"seedance-1.0-lite-ref2v",
"ltx-2-19b",
"ltx-2-19b-distilled",
"ltx-2.3",
"ltx-2.3-fast"
],
"type": "string"
},
"visualStyle": {
"description": "Optional art direction override. A Story Kit style is used when omitted.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"voiceId": {
"description": "Optional voice override from the BlitzReels voice catalog. The Story Kit narrator voice is used when omitted.",
"maxLength": 200,
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"script"
],
"type": "object"
},
"name": "generation_faceless_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"generation": {
"properties": {
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"generation"
],
"type": "object"
}
},
{
"description": "Queue an AI image generation into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aspectRatio": {
"default": "1:1",
"description": "Output aspect ratio.",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"5:4",
"4:5",
"21:9"
],
"type": "string"
},
"enhancePrompt": {
"default": false,
"description": "Enhance using BlitzReels model grammar and actual input context.",
"type": "boolean"
},
"folderId": {
"description": "Optional media library folder ID.",
"format": "uuid",
"type": "string"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"model": {
"default": "fal-ai/nano-banana-2",
"description": "Image model. Call generation_options_list for costs.",
"enum": [
"fal-ai/gpt-image-1",
"fal-ai/gpt-image-1.5",
"fal-ai/gpt-image-2",
"fal-ai/gpt-image-2.5-flare",
"fal-ai/gpt-image-2.5-sunburst",
"xai/grok-imagine-image-2.0",
"fal-ai/bytedance/seedream/v5/lite/text-to-image",
"bytedance/seedream/v5/pro/text-to-image",
"fal-ai/krea-2/turbo",
"fal-ai/krea/v2/medium/turbo/text-to-image",
"fal-ai/krea/v2/medium/text-to-image",
"fal-ai/nano-banana-2",
"google/nano-banana-2-lite",
"fal-ai/nano-banana-pro"
],
"type": "string"
},
"prompt": {
"description": "What the image should show (8-5000 characters).",
"maxLength": 5000,
"minLength": 8,
"type": "string"
},
"referenceAssetIds": {
"default": [],
"description": "Ordered image references. Model-specific limits are listed in generation_options_list; unsupported references fail.",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 14,
"type": "array"
},
"resolution": {
"anyOf": [
{
"enum": [
"0.5k",
"1k",
"2k",
"4k"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Native image resolution. Call generation_options_list for model support and resolution pricing. Unsupported settings are rejected."
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "generation_image_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"generation": {
"properties": {
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"generation"
],
"type": "object"
}
},
{
"description": "Request cancellation of the identified queued or running generation. Work already performed can consume credits; cancellation does not establish a refund.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"jobId": {
"description": "Job ID returned by any generation_*_create tool.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "generation_jobs_cancel",
"outputSchema": {
"additionalProperties": false,
"properties": {
"job": {
"properties": {
"completed_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"download_url": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"progress": {
"type": "number"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"queued",
"processing",
"complete",
"failed",
"canceled"
],
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"progress"
],
"type": "object"
}
},
"required": [
"job"
],
"type": "object"
}
},
{
"description": "Check a queued generation. Completed jobs carry the media asset ID and a download URL.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"jobId": {
"description": "Job ID returned by any generation_*_create tool.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "generation_jobs_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"job": {
"properties": {
"completed_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"download_url": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"progress": {
"type": "number"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"queued",
"processing",
"complete",
"failed",
"canceled"
],
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"progress"
],
"type": "object"
}
},
"required": [
"job"
],
"type": "object"
}
},
{
"description": "Queue a background music track into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"default": 30,
"description": "Track length between 10 and 120 seconds.",
"maximum": 120,
"minimum": 10,
"type": "number"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"mood": {
"default": "neutral",
"description": "Track mood.",
"enum": [
"curiosity",
"intrigue",
"urgency",
"tension",
"concern",
"surprise",
"hope",
"satisfaction",
"inspiration",
"revelation",
"neutral"
],
"type": "string"
},
"prompt": {
"default": "",
"description": "Optional description of the track.",
"maxLength": 500,
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "generation_music_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"generation": {
"properties": {
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"generation"
],
"type": "object"
}
},
{
"description": "List the models, defaults, limits, and credit costs available for one generation kind before queueing it. Video duration is an enum per model (durations_seconds), not a min-max range.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"kind": {
"description": "Generation kind to describe.",
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"name": "generation_options_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"options": {
"type": "object"
}
},
"required": [
"options"
],
"type": "object"
}
},
{
"description": "Read a generation brief from rawPrompt. Source-video edits return execution for generation_video_create with required assets and transformation controls. New scenes return an authoring grammar and planJsonSchema for generation_plan_validate. This read does not generate media or spend credits.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aspectRatio": {
"default": "9:16",
"enum": [
"9:16",
"16:9",
"1:1"
],
"type": "string"
},
"genre": {
"description": "Genre pack id (e.g. pixar-culture-skit). The brief lists available ids in availableGenres; the pack's beats and visual contract override the generic grammar.",
"type": "string"
},
"rawPrompt": {
"description": "Original request. Clone or character-replacement requests select a video transformation brief instead of a new-story plan.",
"maxLength": 5000,
"type": "string"
},
"targetDurationSeconds": {
"default": 15,
"description": "Desired final video duration in seconds.",
"maximum": 300,
"minimum": 2,
"type": "number"
},
"videoModelId": {
"description": "Target video model id (see generation_options_list, kind: video). Defaults to the strongest single-take model.",
"type": "string"
},
"visualStyle": {
"description": "Visual style preset id; its locked style contract is included in the brief.",
"type": "string"
}
},
"type": "object"
},
"name": "generation_plan_brief",
"outputSchema": {
"additionalProperties": false,
"properties": {
"brief": {
"properties": {
"allowedModes": {
"items": {
"type": "string"
},
"type": "array"
},
"aspectRatio": {
"type": "string"
},
"availableGenres": {
"items": {
"type": "string"
},
"type": "array"
},
"execution": {
"description": "Source-video operation, model and required assets; null for new-story plans.",
"type": [
"object",
"null"
]
},
"genrePack": {
"type": [
"string",
"null"
]
},
"grammar": {
"type": "string"
},
"instructions": {
"type": "string"
},
"maxSingleTakeSeconds": {
"type": "number"
},
"modelLabel": {
"type": "string"
},
"planJsonSchema": {
"type": "object"
},
"styleContract": {
"type": [
"string",
"null"
]
},
"supportsNativeAudio": {
"type": "boolean"
},
"targetDurationSeconds": {
"type": "number"
},
"videoModelId": {
"type": "string"
}
},
"required": [
"instructions",
"videoModelId",
"modelLabel",
"supportsNativeAudio",
"maxSingleTakeSeconds",
"allowedModes",
"targetDurationSeconds",
"aspectRatio",
"styleContract",
"grammar",
"planJsonSchema"
],
"type": "object"
}
},
"required": [
"brief"
],
"type": "object"
}
},
{
"description": "Validate a self-authored generation plan against the schema and the target model's real capabilities before execution. Returns directive errors to fix and revalidate; only a valid plan is executable.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"plan": {
"additionalProperties": true,
"description": "The generation plan object authored from generation_plan_brief's planJsonSchema.",
"type": "object"
}
},
"required": [
"plan"
],
"type": "object"
},
"name": "generation_plan_validate",
"outputSchema": {
"additionalProperties": false,
"properties": {
"errors": {
"description": "Empty when valid. Each entry states exactly what to change.",
"items": {
"type": "string"
},
"type": "array"
},
"valid": {
"type": "boolean"
}
},
"required": [
"valid",
"errors"
],
"type": "object"
}
},
{
"description": "Queue a sound effect into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"default": 2,
"description": "Effect length between 0.5 and 30 seconds.",
"maximum": 30,
"minimum": 0.5,
"type": "number"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"loop": {
"default": false,
"description": "Produce a seamlessly loopable effect.",
"type": "boolean"
},
"prompt": {
"description": "The sound to create (3-500 characters).",
"maxLength": 500,
"minLength": 3,
"type": "string"
},
"promptInfluence": {
"default": 0.5,
"description": "How literally to follow the prompt, between 0 and 1. Higher is more literal.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "generation_sound_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"generation": {
"properties": {
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"generation"
],
"type": "object"
}
},
{
"description": "Queue video generation, image animation, source-video editing or character replacement into the media library. Editing accepts referenceVideoAssetIds and transformation controls, including original-audio preservation. Spends AI credits and returns a job readable with generation_jobs_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aspectRatio": {
"default": "9:16",
"description": "Output aspect ratio.",
"enum": [
"9:16",
"16:9",
"1:1"
],
"type": "string"
},
"durationSeconds": {
"default": 5,
"description": "Video transformations inherit the processed source duration and aspect ratio; duration_seconds is not a trim request. Choose a value from the selected model's durations_seconds. duration_seconds_min and duration_seconds_max are the bounds of that list, not a continuous range.",
"maximum": 30,
"minimum": 2,
"type": "integer"
},
"endFrameAssetId": {
"description": "Last-frame still. Interpolates from the source first frame to this image across the full duration. Requires a source first frame; cannot combine with reference arrays.",
"format": "uuid",
"type": "string"
},
"enhancePrompt": {
"default": false,
"description": "Enhance using BlitzReels model grammar and actual input context.",
"type": "boolean"
},
"folderId": {
"description": "Optional media library folder ID.",
"format": "uuid",
"type": "string"
},
"generateAudio": {
"description": "null uses model audio behavior. Explicit true/false must be supported by the selected model.",
"type": "boolean"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"model": {
"default": "wan-2.1",
"description": "Video model. generation_options_list publishes generation type, source limits, character controls, resolution and pricing for each model.",
"enum": [
"seedance-2.5-edit",
"kling-o3-standard-edit",
"kling-o3-pro-edit",
"kling-v3-standard-motion-control",
"kling-v3-pro-motion-control",
"wan-2.2-animate-replace",
"kling-2.1",
"kling-2.6-pro",
"kling-o1",
"kling-3.0",
"kling-o3-standard",
"kling-o3-pro",
"kling-o3-4k",
"kling-v3-pro",
"minimax-01",
"minimax-hailuo-02",
"minimax-hailuo-2.3-pro",
"minimax-h3-max",
"luma-ray-2",
"luma-ray-3.2",
"minimax-hailuo-2.3-pro-t2v",
"minimax-h3-max-t2v",
"luma-ray-3.2-t2v",
"veo3",
"veo3.1",
"veo3.1-fast",
"gemini-omni-flash-ref2v",
"gemini-omni-flash-edit",
"gemini-omni-flash",
"veo3-fast",
"gemini-omni-flash-t2v",
"wan-2.1",
"wan-2.7",
"wan-2.7-ref2v",
"wan-2.7-t2v",
"wan-3.0",
"wan-3.0-t2v",
"happy-horse",
"happy-horse-ref2v",
"happy-horse-t2v",
"pixverse-v6",
"pixverse-v6-t2v",
"krea-wan-14b-t2v",
"grok-imagine",
"grok-imagine-t2v",
"seedance-2.0-pro",
"seedance-2.5",
"seedance-2.0-pro-fast",
"seedance-2.0-ref2v",
"seedance-2.0-ref2v-fast",
"seedance-2.0-pro-t2v",
"seedance-2.5-t2v",
"seedance-2.0-pro-fast-t2v",
"seedance-1.5-pro",
"seedance-1.5-pro-t2v",
"seedance-1.0-pro",
"seedance-1.0-pro-t2v",
"seedance-1.0-pro-fast",
"seedance-1.0-pro-fast-t2v",
"seedance-1.0-lite",
"seedance-1.0-lite-t2v",
"seedance-1.0-lite-ref2v",
"kling-o3-standard-t2v",
"kling-o3-pro-t2v",
"kling-v3-standard-t2v",
"kling-v3-pro-t2v",
"ltx-2-19b",
"ltx-2-19b-distilled",
"ltx-2.3",
"ltx-2.3-fast",
"ltx-2-19b-t2v",
"ltx-2-19b-distilled-t2v",
"ltx-2.3-t2v",
"ltx-2.3-fast-t2v"
],
"type": "string"
},
"negativePrompt": {
"description": "What to avoid in the shot.",
"maxLength": 2500,
"type": "string"
},
"prompt": {
"description": "What should happen in the shot (3-5000 characters).",
"maxLength": 5000,
"minLength": 3,
"type": "string"
},
"provider": {
"default": "auto",
"description": "Explicit provider must support the model and input mode. auto uses a configured compatible provider.",
"enum": [
"auto",
"byteplus-modelark",
"fal"
],
"type": "string"
},
"referenceAssetIds": {
"default": [],
"description": "Ordered reference images: Seedance 2.5 up to 30; Seedance 2.0 ref2v up to 9; other reference models up to 4. Source counts toward the limit.",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 30,
"type": "array"
},
"referenceAudioAssetIds": {
"default": [],
"description": "Reference audio: Seedance 2.5 up to 10; Seedance 2.0 ref2v and fast up to 3. Other models reject them.",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"referenceVideoAssetIds": {
"default": [],
"description": "Video transformations require one processed source video. Other reference modes have model-specific counts published by generation_options_list.",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"resolution": {
"anyOf": [
{
"enum": [
"480p",
"720p",
"768p",
"1080p",
"4k"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Output resolution. Call generation_options_list for model-specific supported values and defaults. Unsupported settings are rejected."
},
"seed": {
"description": "Optional seed for reproducible output.",
"type": "integer"
},
"sourceAssetId": {
"description": "First-frame still. Required only when that model's parameters.source_asset_id.required is true. Optional on reference-capable I2V including Seedance 2.5. Text-to-video rejects it. Cannot combine with reference arrays and end_frame_asset_id.",
"format": "uuid",
"type": "string"
},
"transformation": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"characterOrientation": {
"default": "video",
"enum": [
"video",
"image"
],
"type": "string"
},
"characters": {
"default": [],
"items": {
"additionalProperties": false,
"properties": {
"frontalAssetId": {
"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)$",
"type": "string"
},
"referenceAssetIds": {
"default": [],
"items": {
"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)$",
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"sourceRole": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"sourceRole",
"frontalAssetId",
"referenceAssetIds"
],
"type": "object"
},
"maxItems": 4,
"type": "array"
},
"keepOriginalAudio": {
"default": true,
"type": "boolean"
},
"sourcePersonCount": {
"anyOf": [
{
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"characters",
"sourcePersonCount",
"keepOriginalAudio",
"characterOrientation"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "generation_video_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"generation": {
"properties": {
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"generation"
],
"type": "object"
}
},
{
"description": "Queue a text-to-speech voiceover into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"speed": {
"default": 1,
"description": "Speaking rate between 0.5 and 1.6.",
"maximum": 1.6,
"minimum": 0.5,
"type": "number"
},
"text": {
"description": "Script to read aloud (3-8000 characters).",
"maxLength": 8000,
"minLength": 3,
"type": "string"
},
"voiceId": {
"default": "pNInz6obpgDQGcFmaJgB",
"description": "Voice ID. Call generation_options_list with kind voiceover for the catalog.",
"enum": [
"pNInz6obpgDQGcFmaJgB",
"TX3LPaxmHKxFdv7VOQHJ",
"FGY2WhTYpPnrIDTdsKH5",
"IKne3meq5aSn9XLyUdCD",
"cgSgspJ2msm6clMCkdW9",
"bIHbv24MWmeRgasZH58o",
"nPczCjzI2devNBz1zQrb",
"JBFqnCBsd6RMkjVDRZzb",
"SOYHLrjzK2X1ezoPC6cr",
"N2lVS1w4EtoT3dr4eOWO",
"S9EGwlCtMF7VXtENq79v",
"VhxAIIZM8IRmnl5fyeyk",
"hpp4J3VqNfWAUOO0d1Us",
"EXAVITQu4vr4xnSDxMaL",
"pFZP5JQG7iQjIQuC4Bku",
"SAz9YHcvj6GT2YYXdXww",
"Xb7hH8MSUJpSbSDYk0k2",
"XrExE9yKIg1WjnnlVkGX",
"onwK4e9ZLuTAKqWW03F9",
"pqHfZKP75CvOlQylNhV4",
"CwhRBWXzGAHq8TQ4Fs17",
"cjVigY5qzO86Huf0OWal",
"iP95p4xoKVk53GoZ742B"
],
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"voiceStyle": {
"default": "neutral",
"description": "Delivery emotion.",
"enum": [
"curiosity",
"intrigue",
"urgency",
"tension",
"concern",
"surprise",
"hope",
"satisfaction",
"inspiration",
"revelation",
"neutral"
],
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"name": "generation_voiceover_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"generation": {
"properties": {
"estimated_credits": {
"type": [
"number",
"null"
]
},
"job_id": {
"type": "string"
},
"kind": {
"enum": [
"image",
"video",
"voiceover",
"music",
"sound",
"faceless"
],
"type": "string"
},
"media_id": {
"type": [
"string",
"null"
]
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"project_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"job_id",
"kind",
"status",
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"generation"
],
"type": "object"
}
},
{
"description": "Get metadata and processing state for one media-library asset without returning transcript segments.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "Media asset UUID. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"assetId"
],
"type": "object"
},
"name": "media_assets_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"asset": {
"properties": {
"assetType": {
"enum": [
"video",
"audio",
"image",
"document"
],
"type": "string"
},
"createdAt": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"dimensionsHeight": {
"type": [
"number",
"null"
]
},
"dimensionsWidth": {
"type": [
"number",
"null"
]
},
"durationSeconds": {
"type": [
"number",
"null"
]
},
"fileSizeBytes": {
"type": "number"
},
"folderId": {
"type": [
"string",
"null"
]
},
"fps": {
"type": [
"number",
"null"
]
},
"hasAudioStream": {
"type": [
"boolean",
"null"
]
},
"id": {
"type": "string"
},
"mimeType": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"optimizedDimensionsHeight": {
"type": [
"number",
"null"
]
},
"optimizedDimensionsWidth": {
"type": [
"number",
"null"
]
},
"processing": {
"type": "object"
},
"reframeAnalysis": {
"type": "object"
},
"transcription": {
"type": "object"
},
"updatedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"description",
"folderId",
"assetType",
"mimeType",
"fileSizeBytes",
"durationSeconds",
"dimensionsWidth",
"dimensionsHeight",
"optimizedDimensionsWidth",
"optimizedDimensionsHeight",
"fps",
"hasAudioStream",
"processing",
"transcription",
"reframeAnalysis",
"createdAt",
"updatedAt"
],
"type": "object"
}
},
"required": [
"asset"
],
"type": "object"
}
},
{
"description": "Return one bounded JPEG as MCP image content for visual inspection. Images use the stored visual; videos use the existing thumbnail.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "Media asset UUID. UUID string.",
"format": "uuid",
"type": "string"
},
"maxDimension": {
"default": 1024,
"description": "Maximum preview width or height in pixels (256-1536).",
"maximum": 1536,
"minimum": 256,
"type": "integer"
}
},
"required": [
"assetId"
],
"type": "object"
},
"name": "media_assets_preview",
"outputSchema": {
"additionalProperties": false,
"properties": {
"asset": {
"properties": {
"assetType": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"assetType"
],
"type": "object"
},
"preview": {
"properties": {
"byteLength": {
"type": "number"
},
"height": {
"type": "number"
},
"mimeType": {
"type": "string"
},
"width": {
"type": "number"
}
},
"required": [
"mimeType",
"width",
"height",
"byteLength"
],
"type": "object"
}
},
"required": [
"asset",
"preview"
],
"type": "object"
}
},
{
"description": "Rename one media asset, edit its description, move it to a folder, or change B-roll eligibility. Provide at least one of name, description, folderId, or allowUsingAsBroll.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"allowUsingAsBroll": {
"description": "Whether the asset may be selected as B-roll.",
"type": "boolean"
},
"assetId": {
"description": "Media asset UUID. UUID string.",
"format": "uuid",
"type": "string"
},
"description": {
"description": "New description, or null to clear it.",
"maxLength": 5000,
"type": "string"
},
"folderId": {
"description": "Target folder UUID, or null to move the asset to root.",
"format": "uuid",
"type": "string"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"type": "string"
},
"name": {
"description": "New media asset name.",
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"assetId"
],
"type": "object"
},
"name": "media_assets_update",
"outputSchema": {
"additionalProperties": false,
"properties": {
"asset": {
"type": "object"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"txid": {
"type": [
"number",
"null"
]
},
"updatedFields": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"asset",
"updatedFields",
"txid",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Create one media-library folder in a workspace and return a retry-safe mutation receipt.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"description": {
"description": "Optional folder description.",
"maxLength": 1000,
"type": "string"
},
"iconType": {
"default": "folder",
"description": "Folder icon type.",
"enum": [
"folder",
"code",
"video",
"audio",
"image",
"document",
"star",
"spark"
],
"type": "string"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"type": "string"
},
"name": {
"description": "Folder name.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"parentFolderId": {
"description": "Parent folder UUID, or null for the root.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Workspace UUID, or null for the default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "media_folders_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"folder": {
"type": "object"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
}
},
"required": [
"folder",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "List one bounded level of media-library folders and direct asset counts.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum folders to return (1-50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Folder offset.",
"minimum": 0,
"type": "integer"
},
"parentFolderId": {
"description": "Parent folder UUID, or null for root folders.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Workspace UUID, or null for the default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "media_folders_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"folders": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"folders",
"bounds"
],
"type": "object"
}
},
{
"description": "Inspect a user-provided public social-video or Google Drive URL and return available import metadata without creating media.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "Public video URL. Supports social video links and Google Drive file links.",
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "media_import_inspect",
"outputSchema": {
"additionalProperties": false,
"properties": {
"preview": {
"type": "object"
}
},
"required": [
"preview"
],
"type": "object"
}
},
{
"description": "Scan a user-controlled public page and return an importable video URL found on it without creating media.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"confirmAuthorizedToScan": {
"default": false,
"description": "Set true only after the user confirms they control the page or are authorized to scan it.",
"type": "boolean"
},
"url": {
"description": "Video page URL or direct media URL to inspect for an importable video.",
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "media_import_scan_page",
"outputSchema": {
"additionalProperties": false,
"properties": {
"resolved": {
"type": "object"
}
},
"required": [
"resolved"
],
"type": "object"
}
},
{
"description": "Import a video, audio, or image from a user-provided direct URL into the private BlitzReels media library.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"contentHashSha256": {
"description": "Optional SHA-256 hex hash of file bytes for dedupe optimization. 64-character hex string.",
"pattern": "^[a-fA-F0-9]{64}$",
"type": "string"
},
"name": {
"description": "Optional name for the file",
"type": "string"
},
"projectId": {
"description": "Optional project ID to associate the upload with. UUID string.",
"format": "uuid",
"type": "string"
},
"url": {
"description": "URL of the media file to download and upload",
"format": "uri",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "media_import_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"media": {
"type": "object"
}
},
"required": [
"media"
],
"type": "object"
}
},
{
"description": "List media files in user's library (videos, audio, images)",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetType": {
"default": "all",
"description": "Filter by asset type",
"enum": [
"video",
"audio",
"image",
"all"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum number of assets to return (1-50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Media asset offset.",
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "media_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"assets": {
"items": {
"type": "object"
},
"type": "array"
},
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
}
},
"required": [
"assets",
"bounds"
],
"type": "object"
}
},
{
"description": "Get transcript summary metadata or a bounded window of transcription segments for a video asset.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "The media asset ID to get transcript for. UUID string.",
"format": "uuid",
"type": "string"
},
"limit": {
"default": 50,
"description": "Maximum transcript segments to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"mode": {
"default": "summary",
"description": "Summary returns metadata only. Text returns joined text for a bounded segment window. Full returns the bounded segment objects without duplicating their text.",
"enum": [
"summary",
"text",
"full"
],
"type": "string"
},
"offset": {
"default": 0,
"description": "Transcript segment offset.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"assetId"
],
"type": "object"
},
"name": "media_transcript_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"error": {
"type": "string"
},
"transcript": {
"properties": {
"segmentBounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"segments": {
"items": {
"type": "object"
},
"type": "array"
},
"text": {
"type": [
"string",
"null"
]
}
},
"required": [
"text",
"segments",
"segmentBounds"
],
"type": [
"object",
"null"
]
}
},
"required": [
"transcript"
],
"type": "object"
}
},
{
"description": "Import a video, audio, or image file from ChatGPT into the BlitzReels media library. Use this for a file the user attached or picked, and for an image ChatGPT generated in this conversation that the user wants to keep, animate, or edit in BlitzReels.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"file": {
"description": "A file from ChatGPT: attached by the user, picked from their file library, or produced earlier in this conversation. ChatGPT provides this value.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"name": {
"description": "Optional name to use in BlitzReels.",
"type": "string"
},
"projectId": {
"description": "Optional BlitzReels project ID to associate with the uploaded file. UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"file"
],
"type": "object"
},
"name": "media_upload_file",
"outputSchema": {
"additionalProperties": false,
"properties": {
"media": {
"type": "object"
}
},
"required": [
"media"
],
"type": "object"
}
},
{
"description": "Complete the upload process after uploading to a presigned URL",
"inputSchema": {
"additionalProperties": false,
"properties": {
"contentHashSha256": {
"description": "Optional SHA-256 hex hash of file bytes for dedupe optimization. 64-character hex string.",
"pattern": "^[a-fA-F0-9]{64}$",
"type": "string"
},
"contentType": {
"description": "MIME type of the file",
"type": "string"
},
"fileName": {
"description": "Name of the uploaded file",
"type": "string"
},
"fileSizeBytes": {
"description": "Size of the uploaded file in bytes",
"minimum": 1,
"type": "number"
},
"projectId": {
"description": "Optional project ID to associate the upload with. UUID string.",
"format": "uuid",
"type": "string"
},
"storageKey": {
"description": "Storage key for the uploaded file",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"storageKey",
"fileName",
"contentType",
"fileSizeBytes"
],
"type": "object"
},
"name": "media_upload_finish",
"outputSchema": {
"additionalProperties": false,
"properties": {
"media": {
"type": "object"
}
},
"required": [
"media"
],
"type": "object"
}
},
{
"description": "Get a presigned URL for direct file upload (for large files)",
"inputSchema": {
"additionalProperties": false,
"properties": {
"contentType": {
"description": "MIME type (e.g., video/mp4, audio/mp3, image/jpeg)",
"type": "string"
},
"fileName": {
"description": "Name of the file to upload",
"type": "string"
},
"projectId": {
"description": "Optional project ID to associate the upload with. UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID when projectId is not provided. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"fileName",
"contentType"
],
"type": "object"
},
"name": "media_upload_start",
"outputSchema": {
"additionalProperties": false,
"properties": {
"uploadInfo": {
"type": "object"
}
},
"required": [
"uploadInfo"
],
"type": "object"
}
},
{
"description": "Queue a ByteDance upscale of one stored video asset to 1080p or 4k. Call media_upscale_estimate first. Spends AI credits and returns a new pending media asset to poll with media_assets_get.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "Source video asset UUID. UUID string.",
"format": "uuid",
"type": "string"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"type": "string"
},
"projectId": {
"description": "Optional project UUID to attach the credit spend. UUID string.",
"format": "uuid",
"type": "string"
},
"targetResolution": {
"description": "Output long-edge target.",
"enum": [
"1080p",
"4k"
],
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"assetId",
"targetResolution"
],
"type": "object"
},
"name": "media_upscale",
"outputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"type": "string"
},
"creditsRequired": {
"type": "number"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"runId": {
"type": "string"
},
"sourceAssetId": {
"type": "string"
},
"status": {
"enum": [
"queued"
],
"type": "string"
},
"targetResolution": {
"enum": [
"1080p",
"4k"
],
"type": "string"
}
},
"required": [
"assetId",
"sourceAssetId",
"targetResolution",
"creditsRequired",
"runId",
"status",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Estimate ByteDance upscale eligibility and credits for one stored video. Does not spend credits or queue a job. Call this before media_upscale.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "Source video asset UUID. UUID string.",
"format": "uuid",
"type": "string"
},
"projectId": {
"description": "Optional project UUID for the estimate context. UUID string.",
"format": "uuid",
"type": "string"
},
"targetResolution": {
"description": "Output long-edge target.",
"enum": [
"1080p",
"4k"
],
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"assetId",
"targetResolution"
],
"type": "object"
},
"name": "media_upscale_estimate",
"outputSchema": {
"additionalProperties": false,
"properties": {
"creditsRequired": {
"type": "number"
},
"durationSeconds": {
"type": "number"
},
"eligible": {
"type": "boolean"
},
"ineligibleReason": {
"type": [
"string",
"null"
]
},
"sourceLongEdge": {
"type": "number"
},
"targetFps": {
"enum": [
"30fps",
"60fps"
],
"type": "string"
},
"targetLongEdge": {
"type": "number"
},
"targetResolution": {
"enum": [
"1080p",
"4k"
],
"type": "string"
}
},
"required": [
"eligible",
"ineligibleReason",
"targetResolution",
"targetFps",
"creditsRequired",
"durationSeconds",
"sourceLongEdge",
"targetLongEdge"
],
"type": "object"
}
},
{
"description": "Set one timeline media item's volume to zero.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"projectId",
"timelineItemId",
"idempotencyKey"
],
"type": "object"
},
"name": "mute_clip_audio",
"outputSchema": {
"additionalProperties": false,
"properties": {
"affectedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"baseRevision": {
"type": "integer"
},
"createdTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"deletedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"operationId": {
"type": "string"
},
"projectId": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"type": "object"
},
"revision": {
"type": "integer"
},
"txid": {
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"operationId",
"projectId",
"baseRevision",
"revision",
"replayed",
"txid",
"affectedTimelineItemIds",
"createdTimelineItemIds",
"deletedTimelineItemIds",
"warnings",
"result",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Create a new private BlitzReels video project.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aspectRatio": {
"default": "9:16",
"description": "Video aspect ratio",
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string"
},
"description": {
"description": "Project description (optional, max 500 characters)",
"type": "string"
},
"frameRate": {
"default": "30",
"description": "Video frame rate",
"enum": [
"24",
"25",
"30",
"50",
"60"
],
"type": "string"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"type": "string"
},
"name": {
"description": "Project name (1-100 characters)",
"type": "string"
},
"seriesId": {
"description": "Optional Series UUID for this new project.",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "projects_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"project": {
"properties": {
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
}
},
"required": [
"mutationReceipt"
],
"type": "object"
}
},
"required": [
"project"
],
"type": "object"
}
},
{
"description": "Get details for one BlitzReels project, including timeline summary, clips, captions, and current recovery state with an app path and next read tool.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"projectId": {
"description": "The project ID to get details for. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "projects_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"error": {
"type": "string"
},
"project": {
"type": [
"object",
"null"
]
}
},
"required": [
"project"
],
"type": "object"
}
},
{
"description": "Read bounded project context for editing, including timeline items, media assets, transcripts, captions, and stable IDs.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetLimit": {
"description": "Maximum media assets to return (1-50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"assetOffset": {
"description": "Media asset offset.",
"minimum": 0,
"type": "integer"
},
"captionWordLimit": {
"description": "Maximum caption words to return (1-2000).",
"maximum": 2000,
"minimum": 1,
"type": "integer"
},
"captionWordOffset": {
"description": "Caption word offset.",
"minimum": 0,
"type": "integer"
},
"mode": {
"default": "timeline",
"description": "Bounded project context view to return.",
"enum": [
"summary",
"assets",
"timeline",
"transcript",
"full"
],
"type": "string"
},
"projectId": {
"description": "Project UUID. UUID string.",
"format": "uuid",
"type": "string"
},
"search": {
"description": "Optional media search when mode is assets or full.",
"type": "string"
},
"timelineLimit": {
"description": "Maximum timeline items to return (1-1000).",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"timelineOffset": {
"description": "Timeline item offset.",
"minimum": 0,
"type": "integer"
},
"transcriptLimit": {
"description": "Maximum transcript segments to return (1-500).",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"transcriptOffset": {
"description": "Transcript segment offset.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "projects_inspect",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"properties": {
"collections": {
"items": {
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"name": {
"type": "string"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"name",
"offset",
"limit",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"collections"
],
"type": "object"
},
"data": {
"type": "object"
},
"mode": {
"enum": [
"summary",
"assets",
"timeline",
"transcript",
"full"
],
"type": "string"
}
},
"required": [
"mode",
"data",
"bounds"
],
"type": "object"
}
},
{
"description": "List the user's BlitzReels projects with status, duration, and basic metadata.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"description": "Maximum number of projects to return (1-50)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"offset": {
"default": 0,
"description": "Project offset.",
"minimum": 0,
"type": "number"
},
"search": {
"description": "Search projects by name",
"type": "string"
},
"status": {
"default": "active",
"description": "Filter by project status",
"enum": [
"active",
"archived",
"all"
],
"type": "string"
},
"workspaceId": {
"description": "Optional workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "projects_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"projects": {
"items": {
"additionalProperties": false,
"properties": {
"clipCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"durationSeconds": {
"type": "number"
},
"id": {
"type": "string"
},
"lastExportAt": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"projectUrl": {
"type": "string"
},
"status": {
"enum": [
"ready",
"exporting",
"needs_captions",
"processing",
"failed"
],
"type": "string"
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"updatedAt": {
"type": "string"
}
},
"required": [
"id",
"name",
"description",
"updatedAt",
"lastExportAt",
"durationSeconds",
"clipCount",
"thumbnailUrl",
"status",
"projectUrl"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"projects",
"bounds"
],
"type": "object"
}
},
{
"description": "Produce a batch from a ready synchronized camera and screen recording, with optional clip count, maximum duration and caption look. Preserves readable screen context through the existing layout pipeline. Can spend existing credits; follows clips_get with the returned batch_id.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"captionThemeId": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"clipCount": {
"anyOf": [
{
"maximum": 30,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"maxDurationSeconds": {
"anyOf": [
{
"const": 30,
"type": "integer"
},
{
"const": 60,
"type": "integer"
},
{
"const": 90,
"type": "integer"
},
{
"const": 180,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"recordingSetId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"recordingSetId",
"clipCount",
"maxDurationSeconds",
"captionThemeId"
],
"type": "object"
},
"name": "recording_sets_clips_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Create an empty camera and screen recording set in the explicit workspace. Requires existing recording-set access; does not import files or start processing.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"name"
],
"type": "object"
},
"name": "recording_sets_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Finalize the collected camera and screen tracks and queue analysis. Can spend existing transcription credits. Inspect returned alignment and warnings before clipping.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"recordingSetId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"recordingSetId"
],
"type": "object"
},
"name": "recording_sets_finalize",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Read one camera and screen recording set, its primary speaker, content windows, alignment and warnings. Separate audio-only tracks are not supported.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"recordingSetId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"recordingSetId"
],
"type": "object"
},
"name": "recording_sets_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Read bounded camera and screen recording sets in the selected workspace with status, duration and alignment warnings.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"status": {
"anyOf": [
{
"enum": [
"collecting_assets",
"analyzing",
"finalizing",
"ready",
"failed"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"status",
"limit",
"offset"
],
"type": "object"
},
"name": "recording_sets_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Attach one existing authorized video asset as a camera or screen track. Specify the main speaker when known; alignment happens during finalization.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"asset_id": {
"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)$",
"type": "string"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"is_primary": {
"default": false,
"type": "boolean"
},
"participant_label": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"participant_name": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"recordingSetId": {
"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)$",
"type": "string"
},
"role": {
"enum": [
"camera",
"screen"
],
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"recordingSetId",
"asset_id",
"role",
"participant_label",
"participant_name",
"is_primary"
],
"type": "object"
},
"name": "recording_sets_track_attach",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Create or replace a Growth+ Series identity and defaults. defaultCreationMode selects podcast branding or faceless Story Kit defaults; membership stays mixed. Updates require expectedRevision. Existing content keeps its settings.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"captionThemeId": {
"anyOf": [
{
"maxLength": 120,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"coverAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"defaultCreationMode": {
"default": "podcast",
"enum": [
"podcast",
"faceless"
],
"type": "string"
},
"description": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"expectedRevision": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"seriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"storyKitId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"name",
"defaultCreationMode",
"description",
"coverAssetId",
"logoAssetId",
"storyKitId",
"captionThemeId",
"seriesId",
"expectedRevision",
"workspaceId",
"idempotencyKey"
],
"type": "object"
},
"name": "series_apply",
"outputSchema": {
"additionalProperties": false,
"properties": {
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"series": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"captionThemeId": {
"anyOf": [
{
"maxLength": 120,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"coverAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"createdAt": {
"type": "string"
},
"defaultCreationMode": {
"default": "podcast",
"enum": [
"podcast",
"faceless"
],
"type": "string"
},
"description": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"revision": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"storyKitId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"updatedAt": {
"type": "string"
}
},
"required": [
"name",
"defaultCreationMode",
"description",
"coverAssetId",
"logoAssetId",
"storyKitId",
"captionThemeId",
"id",
"revision",
"createdAt",
"updatedAt"
],
"type": "object"
}
},
"required": [
"series",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Assign, move or detach one source or project using expectedSeriesId. Moving a source does not move existing clips or change branding.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"contentId": {
"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)$",
"type": "string"
},
"expectedSeriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"kind": {
"enum": [
"project",
"source"
],
"type": "string"
},
"seriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"contentId",
"seriesId",
"expectedSeriesId",
"workspaceId",
"idempotencyKey"
],
"type": "object"
},
"name": "series_assign",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"changed": {
"type": "boolean"
},
"id": {
"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)$",
"type": "string"
},
"kind": {
"enum": [
"project",
"source"
],
"type": "string"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"previousSeriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"seriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"kind",
"seriesId",
"previousSeriesId",
"changed",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "List sources or projects in a Series. Null seriesId lists standalone content. sourceId filters projects by clip origin.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"project",
"source"
],
"type": "string"
},
"limit": {
"default": 30,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"search": {
"default": "",
"maxLength": 120,
"type": "string"
},
"seriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"sourceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"limit",
"offset",
"seriesId",
"kind",
"sourceId",
"search",
"workspaceId"
],
"type": "object"
},
"name": "series_content",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"returned": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"type": [
"number",
"null"
]
},
"id": {
"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)$",
"type": "string"
},
"kind": {
"enum": [
"project",
"source"
],
"type": "string"
},
"name": {
"type": "string"
},
"seriesId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"sourceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"kind",
"name",
"seriesId",
"sourceId",
"thumbnailUrl",
"durationSeconds"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"items",
"bounds"
],
"type": "object"
}
},
{
"description": "Delete the Series container at an expected revision and detach its content. Sources, projects and exports are preserved.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"expectedRevision": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"seriesId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"seriesId",
"expectedRevision",
"workspaceId",
"idempotencyKey"
],
"type": "object"
},
"name": "series_delete",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"contentPreserved": {
"const": true,
"type": "boolean"
},
"detachedProjects": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"detachedSources": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"id": {
"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)$",
"type": "string"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
}
},
"required": [
"id",
"detachedProjects",
"detachedSources",
"contentPreserved",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Read a Series identity, creative defaults and revision.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"seriesId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"seriesId"
],
"type": "object"
},
"name": "series_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"series": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"captionThemeId": {
"anyOf": [
{
"maxLength": 120,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"coverAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"createdAt": {
"type": "string"
},
"defaultCreationMode": {
"default": "podcast",
"enum": [
"podcast",
"faceless"
],
"type": "string"
},
"description": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"revision": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"storyKitId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"updatedAt": {
"type": "string"
}
},
"required": [
"name",
"defaultCreationMode",
"description",
"coverAssetId",
"logoAssetId",
"storyKitId",
"captionThemeId",
"id",
"revision",
"createdAt",
"updatedAt"
],
"type": "object"
}
},
"required": [
"series"
],
"type": "object"
}
},
{
"description": "List optional Series with bounded counts and cover previews.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 30,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"limit",
"offset",
"workspaceId"
],
"type": "object"
},
"name": "series_list",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"returned": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"captionThemeId": {
"anyOf": [
{
"maxLength": 120,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"coverAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"coverUrl": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"defaultCreationMode": {
"default": "podcast",
"enum": [
"podcast",
"faceless"
],
"type": "string"
},
"description": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"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)$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"projectCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"revision": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sourceCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"storyKitId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"updatedAt": {
"type": "string"
}
},
"required": [
"name",
"defaultCreationMode",
"description",
"coverAssetId",
"logoAssetId",
"storyKitId",
"captionThemeId",
"id",
"revision",
"createdAt",
"updatedAt",
"coverUrl",
"projectCount",
"sourceCount"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"items",
"bounds"
],
"type": "object"
}
},
{
"description": "Create or update a Story Kit with optimistic concurrency and an idempotent mutation receipt.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"characterIds": {
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"type": "string"
},
"expectedRevision": {
"type": "number"
},
"facts": {
"items": {
"type": "string"
},
"type": "array"
},
"idempotencyKey": {
"type": "string"
},
"locations": {
"items": {
"additionalProperties": false,
"properties": {
"canonicalDescription": {
"type": "string"
},
"facts": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"referenceAssetIds": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"canonicalDescription",
"referenceAssetIds",
"facts"
],
"type": "object"
},
"type": "array"
},
"name": {
"description": "Stable Story Kit name.",
"type": "string"
},
"narratorCharacterId": {
"type": "string"
},
"storyKitId": {
"type": "string"
},
"styleReferenceAssetIds": {
"items": {
"type": "string"
},
"type": "array"
},
"visualStyle": {
"description": "Canonical visual-style contract.",
"type": "string"
},
"workspaceId": {
"description": "Optional workspace UUID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"name",
"visualStyle",
"idempotencyKey"
],
"type": "object"
},
"name": "story_kits_apply",
"outputSchema": {
"additionalProperties": false,
"properties": {
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"storyKit": {
"type": "object"
}
},
"required": [
"storyKit",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "Inspect one Story Kit and its revision before generating or updating a story.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"storyKitId": {
"type": "string"
},
"workspaceId": {
"description": "Optional workspace UUID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"storyKitId"
],
"type": "object"
},
"name": "story_kits_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"storyKit": {
"type": "object"
}
},
"required": [
"storyKit"
],
"type": "object"
}
},
{
"description": "List bounded reusable Story Kits that bind characters, locations, style, facts, and narrator voice.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "number"
},
"offset": {
"default": 0,
"minimum": 0,
"type": "number"
},
"workspaceId": {
"description": "Optional workspace UUID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "story_kits_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"storyKits": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"storyKits",
"bounds"
],
"type": "object"
}
},
{
"description": "Place an audio asset onto a BlitzReels project timeline at a timestamp for voiceover, music, or sound.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"assetId": {
"description": "Audio media asset ID. UUID string.",
"format": "uuid",
"type": "string"
},
"durationSeconds": {
"description": "Optional duration. Required if the audio asset duration is not known yet.",
"minimum": 0,
"type": "number"
},
"fadeInSeconds": {
"default": 0,
"description": "Fade-in length in seconds",
"minimum": 0,
"type": "number"
},
"fadeOutSeconds": {
"default": 0,
"description": "Fade-out length in seconds",
"minimum": 0,
"type": "number"
},
"loop": {
"default": false,
"description": "Loop audio to fill requested duration",
"type": "boolean"
},
"projectId": {
"description": "BlitzReels project ID. UUID string.",
"format": "uuid",
"type": "string"
},
"startSeconds": {
"default": 0,
"description": "Timeline start time in seconds",
"minimum": 0,
"type": "number"
},
"volume": {
"default": 1,
"description": "Audio volume multiplier, 1 is normal",
"type": "number"
}
},
"required": [
"projectId",
"assetId"
],
"type": "object"
},
"name": "timeline_audio_add",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Trim or extend one timeline item. Split one timeline item at an exact sequence position.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"operation": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"operationId": {
"const": "timeline.item.trim",
"type": "string"
},
"snapToFrame": {
"type": "boolean"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
},
"trimEndDeltaSeconds": {
"type": "number"
},
"trimStartDeltaSeconds": {
"type": "number"
}
},
"required": [
"operationId",
"timelineItemId",
"trimStartDeltaSeconds",
"trimEndDeltaSeconds",
"snapToFrame"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"operationId": {
"const": "timeline.item.split",
"type": "string"
},
"snapToFrame": {
"type": "boolean"
},
"splitAtSeconds": {
"minimum": 0,
"type": "number"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"operationId",
"timelineItemId",
"splitAtSeconds",
"snapToFrame"
],
"type": "object"
}
]
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"projectId",
"operation",
"expectedRevision",
"idempotencyKey"
],
"type": "object"
},
"name": "timeline_edit_apply",
"outputSchema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"result": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"affected_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"base_revision": {
"minimum": 0,
"type": "number"
},
"created_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"deleted_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"idempotency_key": {
"type": "string"
},
"mutation_receipt_id": {
"type": "string"
},
"operation_id": {
"const": "timeline.item.trim",
"type": "string"
},
"project_id": {
"format": "uuid",
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"additionalProperties": false,
"properties": {
"message": {
"type": "string"
},
"timeline_item_id": {
"format": "uuid",
"type": "string"
},
"trim_end_seconds": {
"type": "number"
},
"trim_end_units": {
"type": "string"
},
"trim_start_seconds": {
"type": "number"
},
"trim_start_units": {
"type": "string"
}
},
"required": [
"timeline_item_id",
"trim_start_units",
"trim_end_units",
"trim_start_seconds",
"trim_end_seconds",
"message"
],
"type": "object"
},
"revision": {
"minimum": 0,
"type": "number"
},
"success": {
"const": true,
"type": "boolean"
},
"txid": {
"minimum": 0,
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"success",
"operation_id",
"project_id",
"mutation_receipt_id",
"idempotency_key",
"base_revision",
"revision",
"replayed",
"txid",
"affected_timeline_item_ids",
"created_timeline_item_ids",
"deleted_timeline_item_ids",
"warnings",
"result"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"affected_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"base_revision": {
"minimum": 0,
"type": "number"
},
"created_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"deleted_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"idempotency_key": {
"type": "string"
},
"mutation_receipt_id": {
"type": "string"
},
"operation_id": {
"const": "timeline.item.split",
"type": "string"
},
"project_id": {
"format": "uuid",
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"additionalProperties": false,
"properties": {
"left_timeline_item_id": {
"format": "uuid",
"type": "string"
},
"right_timeline_item_id": {
"format": "uuid",
"type": "string"
},
"split_at_seconds": {
"type": "number"
},
"split_at_units": {
"type": "string"
}
},
"required": [
"left_timeline_item_id",
"right_timeline_item_id",
"split_at_units",
"split_at_seconds"
],
"type": "object"
},
"revision": {
"minimum": 0,
"type": "number"
},
"success": {
"const": true,
"type": "boolean"
},
"txid": {
"minimum": 0,
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"success",
"operation_id",
"project_id",
"mutation_receipt_id",
"idempotency_key",
"base_revision",
"revision",
"replayed",
"txid",
"affected_timeline_item_ids",
"created_timeline_item_ids",
"deleted_timeline_item_ids",
"warnings",
"result"
],
"type": "object"
}
]
}
},
"required": [
"result",
"mutationReceipt"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"validation_error",
"not_found",
"permission_denied",
"revision_conflict",
"idempotency_conflict",
"operation_in_progress",
"operation_previous_failure",
"sequence_busy",
"mutation_failed"
],
"type": "string"
},
"details": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"type": "object"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable",
"details"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Preview without mutation. Trim or extend one timeline item. Split one timeline item at an exact sequence position.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"operation": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"operationId": {
"const": "timeline.item.trim",
"type": "string"
},
"snapToFrame": {
"type": "boolean"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
},
"trimEndDeltaSeconds": {
"type": "number"
},
"trimStartDeltaSeconds": {
"type": "number"
}
},
"required": [
"operationId",
"timelineItemId",
"trimStartDeltaSeconds",
"trimEndDeltaSeconds",
"snapToFrame"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"operationId": {
"const": "timeline.item.split",
"type": "string"
},
"snapToFrame": {
"type": "boolean"
},
"splitAtSeconds": {
"minimum": 0,
"type": "number"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"operationId",
"timelineItemId",
"splitAtSeconds",
"snapToFrame"
],
"type": "object"
}
]
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"projectId",
"operation",
"expectedRevision"
],
"type": "object"
},
"name": "timeline_edit_preview",
"outputSchema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"plan": {
"additionalProperties": false,
"properties": {
"affected_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"change_count": {
"minimum": 0,
"type": "number"
},
"current_revision": {
"minimum": 0,
"type": "number"
},
"destructive": {
"type": "boolean"
},
"expected_revision": {
"minimum": 0,
"type": [
"number",
"null"
]
},
"operation_id": {
"enum": [
"timeline.item.trim",
"timeline.item.split"
],
"type": "string"
},
"project_id": {
"format": "uuid",
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"would_create_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"would_delete_timeline_item_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
}
},
"required": [
"operation_id",
"project_id",
"current_revision",
"expected_revision",
"destructive",
"affected_timeline_item_ids",
"would_create_timeline_item_ids",
"would_delete_timeline_item_ids",
"change_count",
"warnings"
],
"type": "object"
}
},
"required": [
"plan"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"validation_error",
"not_found",
"permission_denied",
"revision_conflict",
"idempotency_conflict",
"operation_in_progress",
"operation_previous_failure",
"sequence_busy",
"mutation_failed"
],
"type": "string"
},
"details": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"type": "object"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable",
"details"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Place an image or video asset onto a BlitzReels project timeline at a timestamp, including B-roll and static images.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"allowDuplicate": {
"default": true,
"description": "Allow inserting the same asset more than once",
"type": "boolean"
},
"animationPreset": {
"default": "none",
"description": "Optional visual animation preset",
"enum": [
"none",
"fadeIn",
"fadeOut",
"zoomIn",
"zoomOut",
"slideLeft",
"slideRight",
"slideUp",
"slideDown",
"popIn",
"bounce",
"spin"
],
"type": "string"
},
"assetId": {
"description": "Image or video media asset ID. UUID string.",
"format": "uuid",
"type": "string"
},
"durationSeconds": {
"description": "Duration in seconds. Required for still images when a specific length is needed.",
"minimum": 0,
"type": "number"
},
"layerIndex": {
"description": "Exact timeline layer to use. Lower layer numbers render on top. Omit for intent-based placement.",
"minimum": 0,
"type": "number"
},
"placementIntent": {
"default": "overlay",
"description": "Layer intent used when layerIndex is omitted. Use overlay for visible B-roll/logo/sticker over video, background for behind video, exact when layerIndex is supplied.",
"enum": [
"overlay",
"background",
"exact"
],
"type": "string"
},
"positionPreset": {
"default": "fullscreen",
"description": "Visual placement preset",
"enum": [
"center",
"fullscreen",
"pip-top-left",
"pip-top-right",
"pip-bottom-left",
"pip-bottom-right"
],
"type": "string"
},
"projectId": {
"description": "BlitzReels project ID. UUID string.",
"format": "uuid",
"type": "string"
},
"startSeconds": {
"default": 0,
"description": "Timeline start time in seconds",
"minimum": 0,
"type": "number"
}
},
"required": [
"projectId",
"assetId"
],
"type": "object"
},
"name": "timeline_media_add",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Update one timeline item's start, duration, trim, layer, ignored state, or blurred background. Provide at least one field to update besides timelineItemId.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"blurredBackground": {
"type": "boolean"
},
"durationSeconds": {
"exclusiveMinimum": 0,
"minimum": 0,
"type": "number"
},
"expectedRevision": {
"description": "Expected sequence revision, or null.",
"minimum": 0,
"type": "integer"
},
"idempotencyKey": {
"description": "Retry key. Reuse only with identical inputs.",
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"ignored": {
"type": "boolean"
},
"layerIndex": {
"minimum": 0,
"type": "integer"
},
"projectId": {
"description": "UUID string.",
"format": "uuid",
"type": "string"
},
"startSeconds": {
"minimum": 0,
"type": "number"
},
"timelineItemId": {
"format": "uuid",
"type": "string"
},
"trimEndSeconds": {
"minimum": 0,
"type": "number"
},
"trimStartSeconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"projectId",
"timelineItemId",
"idempotencyKey"
],
"type": "object"
},
"name": "update_timeline_clip",
"outputSchema": {
"additionalProperties": false,
"properties": {
"affectedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"baseRevision": {
"type": "integer"
},
"createdTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"deletedTimelineItemIds": {
"items": {
"type": "string"
},
"type": "array"
},
"mutationReceipt": {
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"operation": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"status": {
"enum": [
"completed"
],
"type": "string"
}
},
"required": [
"id",
"key",
"operation",
"status",
"replayed"
],
"type": "object"
},
"operationId": {
"type": "string"
},
"projectId": {
"type": "string"
},
"replayed": {
"type": "boolean"
},
"result": {
"type": "object"
},
"revision": {
"type": "integer"
},
"txid": {
"type": "number"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"operationId",
"projectId",
"baseRevision",
"revision",
"replayed",
"txid",
"affectedTimelineItemIds",
"createdTimelineItemIds",
"deletedTimelineItemIds",
"warnings",
"result",
"mutationReceipt"
],
"type": "object"
}
},
{
"description": "After the user approves the generated previews and animation cost, confirmApproved=true starts scene animation, narration and editable timeline assembly. Can replace the project's generated timeline and spend existing credits. Follow the revision and then export the finished project.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"confirmApproved": {
"const": true,
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"revisionId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"projectId",
"revisionId",
"confirmApproved"
],
"type": "object"
},
"name": "video_assets_approve",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Save the user's 1-5 rating and optional quality category/comment against one completed playable video export. Replaces that user's previous feedback for this export; does not change accepted clips or defaults. Requires the feedback storage migration to be installed.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"category": {
"anyOf": [
{
"enum": [
"moments",
"captions",
"pacing",
"framing",
"editing",
"export",
"other"
],
"type": "string"
},
{
"type": "null"
}
]
},
"comment": {
"maxLength": 2000,
"type": "string"
},
"exportId": {
"description": "UUID 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)$",
"type": "string"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"rating": {
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"exportId",
"rating",
"category",
"comment"
],
"type": "object"
},
"name": "video_feedback_save",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "After showing the storyboard and its credit estimate, confirmApproved=true starts production of reference images and scene keyframes. Spends existing credits. This stage produces reviewable previews, not animated videos.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"confirmApproved": {
"const": true,
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"revisionId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"projectId",
"revisionId",
"confirmApproved"
],
"type": "object"
},
"name": "video_storyboard_approve",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Replace the identified preview after user approval of the new credit cost. A scene_keyframe changes one keyframe; a character_anchor refreshes its dependent keyframes; a style_anchor refreshes every keyframe. Preserves unaffected previews. Does not regenerate an already finished video shot.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"asset_type": {
"description": "style_anchor regenerates the shared style reference and every keyframe; character_anchor requires character_id and refreshes dependent keyframes; scene_keyframe requires scene_index.",
"enum": [
"style_anchor",
"character_anchor",
"scene_keyframe"
],
"type": "string"
},
"character_id": {
"minLength": 1,
"type": "string"
},
"confirmRegeneration": {
"const": true,
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"revisionId": {
"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)$",
"type": "string"
},
"scene_index": {
"maximum": 11,
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"projectId",
"revisionId",
"asset_type",
"workspaceId",
"idempotencyKey",
"confirmRegeneration"
],
"type": "object"
},
"name": "video_storyboard_asset_regenerate",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Create a vertical video storyboard for the user-approved script in an existing project. Spends planning credits; returns scene narration, factual review notes, references and the production credit estimate. Does not generate images or animate video. Existing account access applies.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"caption_style_id": {
"maxLength": 200,
"type": "string"
},
"character_ids": {
"items": {
"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)$",
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"confirmScriptApproved": {
"const": true,
"type": "boolean"
},
"generate_background_music": {
"type": "boolean"
},
"generate_sound_effects": {
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"image_model_id": {
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"include_captions": {
"type": "boolean"
},
"planner_model_id": {
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"script": {
"maxLength": 30000,
"minLength": 1,
"type": "string"
},
"series_id": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
]
},
"story_kit_id": {
"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)$",
"type": "string"
},
"style_reference_asset_ids": {
"items": {
"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)$",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"target_duration_seconds": {
"maximum": 120,
"minimum": 10,
"type": "number"
},
"video_model": {
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"visual_style": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"voice_id": {
"maxLength": 200,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"projectId",
"script",
"workspaceId",
"idempotencyKey",
"confirmScriptApproved"
],
"type": "object"
},
"name": "video_storyboard_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Read one authorized storyboard revision, its scene and reference previews, estimate, approvals and bounded polling guidance. Refreshes signed previews. Complete means the editable timeline is assembled; use exports_start and exports_list for a downloadable MP4.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"revisionId": {
"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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"projectId",
"revisionId"
],
"type": "object"
},
"name": "video_storyboard_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Create a new immutable draft from a known revision with selected scene, character or model changes. Preserves other scene definitions; requires review and production approval again. Does not generate media or overwrite an approved revision.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"character_updates": {
"items": {
"additionalProperties": false,
"properties": {
"anchor_prompt": {
"maxLength": 3000,
"minLength": 1,
"type": "string"
},
"canonical_description": {
"maxLength": 3000,
"minLength": 1,
"type": "string"
},
"character_id": {
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"character_id"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"image_model_id": {
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
},
"revisionId": {
"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)$",
"type": "string"
},
"scene_updates": {
"items": {
"additionalProperties": false,
"properties": {
"character_ids": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"image_prompt": {
"maxLength": 5000,
"minLength": 1,
"type": "string"
},
"motion_prompt": {
"maxLength": 5000,
"minLength": 1,
"type": "string"
},
"scene_index": {
"maximum": 11,
"minimum": 0,
"type": "integer"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"scene_index"
],
"type": "object"
},
"maxItems": 12,
"type": "array"
},
"style_anchor_prompt": {
"description": "Self-contained prompt for the single reference frame that locks rendering medium, palette, lighting, and grain for every scene. No characters, no text, no interfaces.",
"maxLength": 3000,
"minLength": 1,
"type": "string"
},
"video_model": {
"maxLength": 200,
"minLength": 3,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"projectId",
"revisionId",
"workspaceId",
"idempotencyKey"
],
"type": "object"
},
"name": "video_storyboard_revise",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": true,
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Create or update up to 20 visual blocks in one call after edit timing is settled. Presets: broll-headline, steps, quote, end-screen, key-number, before-after, screenshot-focus, chapter. IDs are scoped to the project; repeating an ID updates it. Asset IDs must belong to the workspace. Atomic, undoable; dryRun validates without writing. Returns IDs and revision. No generation pass.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dryRun": {
"type": "boolean"
},
"expectedRevision": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]+$",
"type": "string"
},
"items": {
"description": "Supply only the fields for the selected preset.",
"items": {
"additionalProperties": false,
"properties": {
"afterAssetId": {
"description": "Required for before-after.",
"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)$",
"type": "string"
},
"assetId": {
"description": "Required for broll-headline and screenshot-focus.",
"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)$",
"type": "string"
},
"at": {
"maximum": 86400,
"minimum": 0,
"type": "number"
},
"attribution": {
"description": "Required for quote.",
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"beforeAssetId": {
"description": "Required for before-after.",
"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)$",
"type": "string"
},
"cta": {
"description": "Required for end-screen.",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"duration": {
"maximum": 30,
"minimum": 1,
"type": "number"
},
"focus": {
"additionalProperties": false,
"description": "Required for screenshot-focus. Normalized rectangle inside the source image.",
"properties": {
"height": {
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number"
},
"width": {
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number"
},
"x": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"y": {
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"x",
"y",
"width",
"height"
],
"type": "object"
},
"id": {
"pattern": "^[a-zA-Z0-9_-]{1,80}$",
"type": "string"
},
"logoAssetId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"description": "Required for end-screen; null for no logo."
},
"number": {
"description": "Required for chapter.",
"maxLength": 4,
"minLength": 1,
"type": "string"
},
"preset": {
"enum": [
"broll-headline",
"steps",
"quote",
"end-screen",
"key-number",
"before-after",
"screenshot-focus",
"chapter"
],
"type": "string"
},
"steps": {
"description": "Required for steps.",
"items": {
"maxLength": 48,
"minLength": 1,
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"type": "array"
},
"suffix": {
"description": "Required for key-number; empty string allowed.",
"maxLength": 8,
"type": "string"
},
"text": {
"description": "Heading, or quote. Max 120 characters except quote: 220.",
"maxLength": 220,
"minLength": 1,
"type": "string"
},
"value": {
"description": "Required for key-number.",
"maximum": 999999,
"minimum": -999999,
"type": "number"
}
},
"required": [
"id",
"at",
"duration",
"preset",
"text"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"projectId": {
"description": "UUID 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)$",
"type": "string"
}
},
"required": [
"projectId",
"items",
"expectedRevision",
"dryRun",
"idempotencyKey"
],
"type": "object"
},
"name": "visuals_apply",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dryRun": {
"type": "boolean"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"compositionId": {
"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)$",
"type": "string"
},
"contentItemId": {
"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)$",
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"created",
"updated"
],
"type": "string"
},
"timelineItemId": {
"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)$",
"type": "string"
}
},
"required": [
"id",
"timelineItemId",
"contentItemId",
"compositionId",
"status"
],
"type": "object"
},
"type": "array"
},
"mutationReceiptId": {
"type": [
"string",
"null"
]
},
"replayed": {
"type": "boolean"
},
"revision": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"success": {
"const": true,
"type": "boolean"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"success",
"dryRun",
"revision",
"mutationReceiptId",
"replayed",
"items",
"warnings"
],
"type": "object"
}
},
{
"description": "Create an interactive workflow run from a workflow and optional inputs.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"inputs": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"type": "object"
},
{
"type": "null"
}
]
},
"default": {},
"description": "Optional workflow input values. Omit to use workflow defaults.",
"type": "object"
},
"projectId": {
"description": "Optional project ID for workflows that operate on an existing project. UUID string.",
"format": "uuid",
"type": "string"
},
"workflowId": {
"description": "Workflow ID to run. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workflowId"
],
"type": "object"
},
"name": "workflow_runs_create",
"outputSchema": {
"additionalProperties": false,
"properties": {
"run": {
"type": "object"
}
},
"required": [
"run"
],
"type": "object"
}
},
{
"description": "Execute one pending workflow run step and return updated run status.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"runId": {
"description": "Workflow run ID. UUID string.",
"format": "uuid",
"type": "string"
},
"stepRunId": {
"description": "Step run ID from workflow_runs_create or workflow_runs_get. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"runId",
"stepRunId"
],
"type": "object"
},
"name": "workflow_runs_execute_step",
"outputSchema": {
"additionalProperties": false,
"properties": {
"result": {
"type": "object"
},
"run": {
"type": "object"
}
},
"required": [
"result",
"run"
],
"type": "object"
}
},
{
"description": "Get workflow run status, step statuses, outputs, warnings, and dashboard URL.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"runId": {
"description": "Workflow run ID. UUID string.",
"format": "uuid",
"type": "string"
},
"stepLimit": {
"default": 20,
"description": "Maximum workflow run steps to return (1-100).",
"type": "number"
},
"stepOffset": {
"default": 0,
"description": "Workflow run step offset.",
"type": "number"
}
},
"required": [
"runId"
],
"type": "object"
},
"name": "workflow_runs_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"run": {
"properties": {
"stepBounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"steps": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"steps",
"stepBounds"
],
"type": "object"
}
},
"required": [
"run"
],
"type": "object"
}
},
{
"description": "Get a workflow definition, input schema, defaults, and ordered steps.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"stepLimit": {
"default": 20,
"description": "Maximum workflow steps to return (1-100).",
"type": "number"
},
"stepOffset": {
"default": 0,
"description": "Workflow step offset.",
"type": "number"
},
"workflowId": {
"description": "Workflow ID. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workflowId"
],
"type": "object"
},
"name": "workflows_get",
"outputSchema": {
"additionalProperties": false,
"properties": {
"workflow": {
"properties": {
"stepBounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"steps": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"steps",
"stepBounds"
],
"type": "object"
}
},
"required": [
"workflow"
],
"type": "object"
}
},
{
"description": "Import a public BlitzReels workflow into the user's workspace.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"workflowId": {
"description": "Public workflow ID to import. UUID string.",
"format": "uuid",
"type": "string"
},
"workspaceId": {
"description": "Optional target workspace ID. Defaults to the user's default workspace. UUID string.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workflowId"
],
"type": "object"
},
"name": "workflows_import",
"outputSchema": {
"additionalProperties": false,
"properties": {
"workflow": {
"properties": {
"stepBounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"steps": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"steps",
"stepBounds"
],
"type": "object"
}
},
"required": [
"workflow"
],
"type": "object"
}
},
{
"description": "List public BlitzReels workflows that can be imported into a workspace.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum workflows to return (1-50).",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"offset": {
"default": 0,
"description": "Pagination offset.",
"minimum": 0,
"type": "number"
},
"search": {
"description": "Optional search query for workflow name or description.",
"type": "string"
},
"trigger": {
"description": "Optional trigger filter.",
"enum": [
"video_uploaded",
"project_created",
"export_started",
"manual"
],
"type": "string"
}
},
"type": "object"
},
"name": "workflows_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"bounds": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"maxLimit": {
"type": "number"
},
"offset": {
"type": "number"
},
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"maxLimit",
"offset",
"total",
"returned",
"hasMore",
"truncated"
],
"type": "object"
},
"workflows": {
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"workflows",
"bounds"
],
"type": "object"
}
},
{
"description": "Start extracting a brand profile from the exact website the user supplied and authorized to scan. Saves a draft profile for review; does not apply discovered fields to existing videos. Can spend existing account credits.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"confirmAuthorizedToScan": {
"const": true,
"type": "boolean"
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"websiteUrl": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"websiteUrl",
"confirmAuthorizedToScan"
],
"type": "object"
},
"name": "workspace_brand_scan",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read one authorized website extraction run and its draft business profile. Show the extracted fields to the user for review before saving them as defaults.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"runId": {
"description": "UUID 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)$",
"type": "string"
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"runId"
],
"type": "object"
},
"name": "workspace_brand_scan_get",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Read the selected workspace's business audience, offer, reviewed brand defaults, protected vocabulary, editorial purpose, language, avoided terms, pronunciation notes and existing account entitlements. Returns current export quality and watermark constraints without pricing or upgrade links.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId"
],
"type": "object"
},
"name": "workspace_context_get",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Save the user-reviewed business name, audience, offer, conversion goal, tone, protected vocabulary and editorial preferences for the selected workspace. Requires workspace settings permission and confirmReviewed=true; changes future assistant guidance, preserving existing projects. Pronunciation notes guide script drafting; they do not retime or replace source speech.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"audience": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
]
},
"brandName": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
},
"confirmReviewed": {
"const": true,
"type": "boolean"
},
"conversionGoal": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
]
},
"editorialPreferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avoidTerms": {
"items": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"maxItems": 40,
"type": "array"
},
"preferredLanguage": {
"anyOf": [
{
"maxLength": 40,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
]
},
"pronunciationNotes": {
"items": {
"additionalProperties": false,
"properties": {
"pronunciation": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"term": {
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"term",
"pronunciation"
],
"type": "object"
},
"maxItems": 40,
"type": "array"
},
"purpose": {
"anyOf": [
{
"enum": [
"authority",
"education",
"product_demo",
"lead_generation"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"purpose",
"preferredLanguage",
"avoidTerms",
"pronunciationNotes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"idempotencyKey": {
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"offer": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
]
},
"protectedWords": {
"items": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"maxItems": 40,
"type": "array"
},
"tone": {
"anyOf": [
{
"maxLength": 240,
"type": "string"
},
{
"type": "null"
}
]
},
"workspaceId": {
"anyOf": [
{
"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)$",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"workspaceId",
"idempotencyKey",
"brandName",
"audience",
"offer",
"conversionGoal",
"tone",
"editorialPreferences",
"protectedWords",
"confirmReviewed"
],
"type": "object"
},
"name": "workspace_context_save",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List bounded workspaces the connected user belongs to, with their role and default workspace. Selecting a workspace for the task does not change account defaults.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"limit",
"offset"
],
"type": "object"
},
"name": "workspaces_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:31c7ffe4e5a2afb1eac4919216894d52e06bc008c202082c2dc3bbfc93d562b2 | sha256sum