{"openapi":"3.1.0","info":{"title":"BlitzReels API","description":"Create AI-powered videos programmatically","version":"1.0.0"},"servers":[{"url":"https://blitzreels.com/api/v1","description":"Canonical API server"}],"tags":[{"name":"Project Management","description":"Create, inspect, and update video projects."},{"name":"Project Context","description":"Read project state, timeline context, and preview frames before editing."},{"name":"Timeline Editing","description":"Apply creator-controlled timeline edits such as text, audio, overlays, and layout changes."},{"name":"Captions and Themes","description":"Manage captions, caption words, fonts, and Caption Looks."},{"name":"Media Library","description":"Upload, inspect, reframe, and manage source media assets."},{"name":"Onboarding","description":"Prepare workspace brand context, scan websites, import logos, and complete onboarding."},{"name":"Clip Creation","description":"Find, preview, and generate short-form clips from source media."},{"name":"AI Generation","description":"Run AI generation workflows that create new video content."},{"name":"Exports and Jobs","description":"Start exports, download renders, and poll asynchronous jobs."},{"name":"Platform","description":"Auth, credits, webhooks, system metadata, and platform utilities."}],"paths":{"/workspace/media/folders/{folderId}/empty":{"post":{"operationId":"createWorkspaceMediaFoldersFolderIdEmpty","summary":"Delete every media asset in a folder without deleting it","description":"Delete every media asset in a folder without deleting it.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"folderId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm_delete":{"default":false,"type":"boolean"},"dry_run":{"default":false,"type":"boolean"},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"dry_run":{"type":"boolean"},"selected_count":{"type":"number"},"deleted_count":{"type":"number"},"selected_ids":{"type":"array","items":{"type":"string"}},"deleted_ids":{"type":"array","items":{"type":"string"}},"failed_count":{"type":"number"},"failed_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"error":{"type":"string"}},"required":["id","error"],"additionalProperties":false}},"impact":{"type":"object","properties":{"linked_project_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"linked_projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"generated_clip_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["linked_project_count","linked_projects","generated_clip_count"],"additionalProperties":false}},"required":["success","dry_run","selected_count","deleted_count","selected_ids","deleted_ids","failed_count","failed_items","impact"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/batch-delete":{"post":{"operationId":"createWorkspaceMediaAssetsBatchDelete","summary":"Delete selected workspace media assets","description":"Delete selected workspace media assets.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"search":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"name_prefix":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"confirm_delete":{"default":false,"type":"boolean"},"dry_run":{"default":false,"type":"boolean"},"reason":{"type":"string","minLength":3,"maxLength":500},"delete_generated_clips":{"default":false,"type":"boolean"},"delete_linked_projects":{"default":false,"type":"boolean"}},"required":["reason"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"dry_run":{"type":"boolean"},"selected_count":{"type":"number"},"deleted_count":{"type":"number"},"selected_ids":{"type":"array","items":{"type":"string"}},"deleted_ids":{"type":"array","items":{"type":"string"}},"failed_count":{"type":"number"},"failed_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"error":{"type":"string"}},"required":["id","error"],"additionalProperties":false}},"impact":{"type":"object","properties":{"linked_project_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"linked_projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"generated_clip_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["linked_project_count","linked_projects","generated_clip_count"],"additionalProperties":false}},"required":["success","dry_run","selected_count","deleted_count","selected_ids","deleted_ids","failed_count","failed_items","impact"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/batch-delete":{"post":{"operationId":"createProjectsBatchDelete","summary":"Delete selected projects","description":"Delete selected projects.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"search":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"name_prefix":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"confirm_delete":{"default":false,"type":"boolean"},"dry_run":{"default":false,"type":"boolean"},"reason":{"type":"string","minLength":3,"maxLength":500},"delete_generated_clips":{"default":false,"type":"boolean"},"delete_linked_projects":{"default":false,"type":"boolean"}},"required":["reason"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"dry_run":{"type":"boolean"},"selected_count":{"type":"number"},"deleted_count":{"type":"number"},"selected_ids":{"type":"array","items":{"type":"string"}},"deleted_ids":{"type":"array","items":{"type":"string"}},"failed_count":{"type":"number"},"failed_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"error":{"type":"string"}},"required":["id","error"],"additionalProperties":false}},"impact":{"type":"object","properties":{"linked_project_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"linked_projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"generated_clip_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["linked_project_count","linked_projects","generated_clip_count"],"additionalProperties":false}},"required":["success","dry_run","selected_count","deleted_count","selected_ids","deleted_ids","failed_count","failed_items","impact"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/":{"get":{"operationId":"getApiStatus","summary":"API status","description":"API status.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"required":["status","name","version"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/auth/validate":{"get":{"operationId":"validateAuth","summary":"Validate API key","description":"Validate API key.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"plan":{"type":"string"},"environment":{"type":"string","enum":["live","test"]},"key_prefix":{"type":"string"},"docs_url":{"type":"string"},"openapi_url":{"type":"string"},"agent_skills":{"type":"object","properties":{"manifest_url":{"type":"string"},"recommended":{"type":"array","items":{"type":"string"}},"minimum_updated_after":{"type":"string"}},"required":["manifest_url","recommended","minimum_updated_after"],"additionalProperties":false}},"required":["success","organization_id","user_id","plan","environment","key_prefix","docs_url","openapi_url","agent_skills"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips/source-preview":{"get":{"operationId":"getClipsSourcePreview","summary":"Preview a YouTube source before clipping","description":"Preview a YouTube source before clipping.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","format":"uri"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","const":"youtube"},"video_id":{"type":"string"},"title":{"type":"string"},"channel_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_url":{"type":"string"},"width":{"anyOf":[{"type":"number"},{"type":"null"}]},"height":{"anyOf":[{"type":"number"},{"type":"null"}]},"fps":{"anyOf":[{"type":"number"},{"type":"null"}]},"available_qualities":{"type":"array","items":{"type":"string"}}},"required":["platform","video_id","title","channel_name","duration_seconds","thumbnail_url","normalized_url","width","height","fps","available_qualities"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clip-batches/{batch_id}":{"get":{"operationId":"getClipBatchesBatchId","summary":"Get a clip batch","description":"Get a clip batch.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"batch_id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"batch_id":{"type":"string"},"status":{"type":"string"},"asset_id":{"type":"string"},"project_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_clip_count":{"type":"number"},"total_clip_count":{"type":"number"},"rendered_count":{"type":"number"},"failed_count":{"type":"number"},"review_count":{"type":"number"},"activity":{},"clips":{"type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"status":{"type":"string"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_preview_urls":{"type":"array","items":{"type":"string"}}},"required":["clip_id","suggestion_id","project_id","export_id","title","status","download_url","error_message","qa_summary","qa_preview_urls"],"additionalProperties":false}},"zip_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"studio_sound":{"type":"object","properties":{"requested":{"type":"boolean"},"status":{"type":"string","enum":["disabled","pending","processing","applied","failed"]},"source_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"enhanced_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requested","status","source_asset_id","enhanced_asset_id","version","processing_run_id","error_message"],"additionalProperties":false}},"required":["batch_id","status","asset_id","project_folder_id","estimated_clip_count","total_clip_count","rendered_count","failed_count","review_count","activity","clips","zip_download_url","last_error_message","studio_sound"],"additionalProperties":false}},"required":["batch"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteClipBatchesBatchId","summary":"Delete a terminal clip batch","description":"Deletes the batch and its clip records. Projects and exports are retained by default; pass delete_projects_and_exports for explicit cascading soft deletion. Active batches and shared projects are protected.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"batch_id","schema":{"type":"string"},"required":true},{"in":"query","name":"retention","schema":{"default":"retain_projects_and_exports","type":"string","enum":["retain_projects_and_exports","delete_projects_and_exports"]}},{"in":"query","name":"dry_run","schema":{"type":"boolean"}},{"in":"query","name":"confirm_delete","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"batch_id":{"type":"string"},"status":{"type":"string"},"retention":{"type":"string","enum":["retain_projects_and_exports","delete_projects_and_exports"]},"dry_run":{"type":"boolean"},"clip_ids":{"type":"array","items":{"type":"string"}},"project_ids":{"type":"array","items":{"type":"string"}},"export_ids":{"type":"array","items":{"type":"string"}},"shared_project_ids":{"type":"array","items":{"type":"string"}},"deleted_batch_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deleted_clip_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deleted_project_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deleted_export_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["batch_id","status","retention","dry_run","clip_ids","project_ids","export_ids","shared_project_ids","deleted_batch_count","deleted_clip_count","deleted_project_count","deleted_export_count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clip-batches/{batch_id}/realtime-token":{"get":{"operationId":"getClipBatchesBatchIdRealtimeToken","summary":"Get a scoped realtime token for a clip batch","description":"Get a scoped realtime token for a clip batch.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"batch_id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string"},"expires_at":{"type":"string"}},"required":["access_token","expires_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips/attach-export":{"post":{"operationId":"createClipsAttachExport","summary":"Attach a visually accepted completed export to managed clips","description":"Attach a visually accepted completed export to managed clips.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"project_id":{"type":"string"},"export_id":{"type":"string"},"confirm_visual_qa":{"type":"boolean","const":true}},"required":["asset_id","project_id","export_id","confirm_visual_qa"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"clip_id":{"type":"string"},"asset_id":{"type":"string"},"project_id":{"type":"string"},"export_id":{"type":"string"},"status":{"type":"string","const":"exported"},"next_action":{"type":"string","const":"stop"},"share_page_eligible":{"type":"boolean","const":true},"replayed":{"type":"boolean"}},"required":["success","clip_id","asset_id","project_id","export_id","status","next_action","share_page_eligible","replayed"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips/{clip_id}/promote-export":{"post":{"operationId":"promoteCompletedExport","summary":"Promote a visually accepted export as a managed delivery","description":"Promote a visually accepted export as a managed delivery.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"export_id":{"type":"string"},"confirm_visual_qa":{"type":"boolean","const":true}},"required":["export_id","confirm_visual_qa"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"clip_id":{"type":"string"},"asset_id":{"type":"string"},"project_id":{"type":"string"},"export_id":{"type":"string"},"status":{"type":"string","const":"exported"},"next_action":{"type":"string","const":"stop"},"share_page_eligible":{"type":"boolean","const":true},"replayed":{"type":"boolean"},"previous_export_id":{"type":"string"}},"required":["success","clip_id","asset_id","project_id","export_id","status","next_action","share_page_eligible","replayed","previous_export_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clip-share-pages/{asset_id}":{"get":{"operationId":"getClipSharePage","summary":"Get a clip share page","description":"Get a clip share page.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"asset_id","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"exists":{"type":"boolean"},"enabled":{"type":"boolean"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"allow_downloads":{"type":"boolean"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"type":"string"},"hidden_clip_ids":{"type":"array","items":{"type":"string"}}},"required":["asset_id","exists","enabled","share_url","allow_downloads","title","description","hidden_clip_ids"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"setClipSharePageEnabled","summary":"Publish or unpublish a clip share page","description":"Publish or unpublish a clip share page.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"asset_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"allow_downloads":{"type":"boolean"}},"required":["enabled"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"exists":{"type":"boolean"},"enabled":{"type":"boolean"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"allow_downloads":{"type":"boolean"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"type":"string"},"hidden_clip_ids":{"type":"array","items":{"type":"string"}}},"required":["asset_id","exists","enabled","share_url","allow_downloads","title","description","hidden_clip_ids"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clip-share-pages/{asset_id}/clips/{clip_id}/visibility":{"post":{"operationId":"setClipSharePageClipVisibility","summary":"Set clip visibility on a share page","description":"Set clip visibility on a share page.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"asset_id","schema":{"type":"string"},"required":true},{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["visible","hidden"]}},"required":["visibility"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"clip_id":{"type":"string"},"visibility":{"type":"string","enum":["visible","hidden"]}},"required":["asset_id","clip_id","visibility"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clip-batches/{batch_id}/recover":{"post":{"operationId":"recoverClipBatch","summary":"Refill a terminal clip batch","description":"Preserves accepted clips and creates an official recovery batch in the same project folder for the missing count.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"batch_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_clip_count":{"default":null,"anyOf":[{"type":"integer","minimum":1,"maximum":30},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source_batch_id":{"type":"string"},"recovery_batch_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"project_folder_id":{"type":"string"},"status":{"type":"string","enum":["satisfied","queued","waiting","failed"]},"target_clip_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retained_clip_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"refill_clip_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unfilled_clip_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"processing_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"queue_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_action":{"type":"string","enum":["poll","stop"]},"duration_policy":{"type":"object","properties":{"mode":{"type":"string","const":"quality_first"},"target_max_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"suggestion_boundaries_preserved":{"type":"boolean","const":true}},"required":["mode","target_max_seconds","suggestion_boundaries_preserved"],"additionalProperties":false}},"required":["source_batch_id","recovery_batch_id","project_folder_id","status","target_clip_count","retained_clip_count","refill_clip_count","unfilled_clip_count","processing_run_id","queue_reason","next_action","duration_policy"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips":{"get":{"operationId":"getClips","summary":"List clips","description":"List clips.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"asset_id","schema":{"type":"string"}},{"in":"query","name":"project_id","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"type":"string","enum":["preparing_source","awaiting_suggestions","selecting_clip","assembling","qa_running","needs_reselection","needs_repair","ready","exporting","exported","failed"]}},{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":50}},{"in":"query","name":"offset","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"clips":{"type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_project_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_clip_preset_id":{"anyOf":[{"type":"string","enum":["default","formation-clipperz","demo-focus","high-retention"]},{"type":"null"}]},"status":{"type":"string","enum":["preparing_source","awaiting_suggestions","selecting_clip","assembling","qa_running","needs_reselection","needs_repair","ready","exporting","exported","failed"]},"next_action":{"type":"string","enum":["poll","reselect","repair","export","stop"]},"error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"blocking_error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"waiting_reason":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"status_detail":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"object","properties":{"source_type":{"type":"string","enum":["asset","youtube"]},"asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"youtube_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_status":{"type":"string","enum":["pending","ready","failed"]},"transcript_status":{"type":"string","enum":["pending","ready","failed"]},"suggestions_status":{"type":"string","enum":["pending","ready","failed"]},"suggestion_counts":{"type":"object","properties":{"saved":{"type":"integer","minimum":0,"maximum":9007199254740991},"drafts":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["saved","drafts","total"],"additionalProperties":false},"suggestion_ai_run_ids":{"type":"array","items":{"type":"string"}},"analysis_status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"processing":{"type":"object","properties":{"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false}},"required":["processing_status","processing_substage","processing_error","processing_errors","processing_attempts","retryable","provider_request_ids"],"additionalProperties":false},"suitability":{"type":"object","properties":{"verdict":{"type":"string","enum":["ready","pending","failed","needs_reselection"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryable":{"type":"boolean"}},"required":["verdict","reason","retryable"],"additionalProperties":false},"readiness_warnings":{"type":"array","items":{"type":"string"}}},"required":["source_type","asset_id","youtube_url","source_status","transcript_status","suggestions_status","suggestion_counts","suggestion_ai_run_ids","analysis_status","analysis_version","canonical_duration_seconds","processing","suitability","readiness_warnings"],"additionalProperties":false},"selection":{"type":"object","properties":{"selection_mode":{"type":"string","enum":["auto_best","suggestion","time_range"]},"requested_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"applied_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alternatives":{"type":"array","items":{"type":"object","properties":{"suggestion_id":{"type":"string"},"title":{"type":"string"},"hook":{"type":"string"},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"score":{"type":"number"}},"required":["suggestion_id","title","hook","start_seconds","end_seconds","duration_seconds","score"],"additionalProperties":false}}},"required":["selection_mode","requested_suggestion_id","applied_suggestion_id","alternatives"],"additionalProperties":false},"clip_window":{"type":"object","properties":{"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["start_seconds","end_seconds","duration_seconds"],"additionalProperties":false},"layout":{"type":"object","properties":{"requested_mode":{"type":"string","enum":["auto","people_first","screen_first","preserve_full_source","prefer_split","prefer_focus","prefer_tutorial","prefer_demo"]},"tutorial_stack_ratio":{"type":"string","enum":["screen_70_face_30","screen_50_face_50"]},"applied_mode":{"type":"string","enum":["split","focus","letterbox","fullscreen","unknown"]},"primary_layout":{"anyOf":[{"type":"string"},{"type":"null"}]},"speaker_aware_applied":{"type":"boolean"},"fallback_used":{"type":"boolean"},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_mode_honored":{"type":"boolean"},"segments":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"layout_key":{"type":"string"},"caption_placement":{"type":"string","enum":["between_speakers","default"]},"panels":{"type":"array","items":{"type":"object","properties":{"track_asset_id":{"type":"string"},"role":{"type":"string","enum":["speaker","share","unknown"]},"canvas":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["x","y","width","height"],"additionalProperties":false},"source_crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]}},"required":["track_asset_id","role","canvas","source_crop","fit_mode"],"additionalProperties":false}}},"required":["start_seconds","end_seconds","duration_seconds","layout_key","caption_placement","panels"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["requested_mode","tutorial_stack_ratio","applied_mode","primary_layout","speaker_aware_applied","fallback_used","fallback_reason","requested_mode_honored","segments","warnings"],"additionalProperties":false},"captions":{"type":"object","properties":{"enabled":{"type":"boolean"},"style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_reveal_animation":{"anyOf":[{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},{"type":"null"}]},"max_lines_per_caption":{"anyOf":[{"type":"integer","minimum":1,"maximum":4},{"type":"null"}]},"words_per_line_limit":{"anyOf":[{"type":"integer","minimum":1,"maximum":16},{"type":"null"}]},"page_combine_ms":{"anyOf":[{"type":"integer","minimum":250,"maximum":10000},{"type":"null"}]},"status":{"type":"string","enum":["pending","ready","failed"]},"clip_window_aware":{"type":"boolean"},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"required":["enabled","style_id","word_reveal_animation","max_lines_per_caption","words_per_line_limit","page_combine_ms","status","clip_window_aware","item_count","warnings"],"additionalProperties":false},"qa":{"type":"object","properties":{"required":{"type":"boolean"},"status":{"type":"string","enum":["pending","passed","failed","bypassed"]},"blocking":{"type":"boolean"},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"code":{"type":"string"},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","code","title","details","suggested_fix"],"additionalProperties":false}},"preview_urls":{"type":"array","items":{"type":"string"}},"visual_debug_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["required","status","blocking","score","summary","issues","preview_urls","visual_debug_url"],"additionalProperties":false},"export":{"type":"object","properties":{"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","export_id","download_url","short_download_url"],"additionalProperties":false},"delivery":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"replacement_pending":{"type":"boolean"}},"required":["project_id","export_id","status","download_url","short_download_url","replacement_pending"],"additionalProperties":false},"request_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["clip_id","project_id","requested_project_name","requested_clip_preset_id","status","next_action","error","blocking_error","waiting_reason","status_detail","source","selection","clip_window","layout","captions","qa","export","delivery","request_id","created_at","updated_at"],"additionalProperties":false}},"bounds":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"returned":{"type":"integer","minimum":0,"maximum":9007199254740991},"has_more":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["limit","offset","total","returned","has_more","truncated"],"additionalProperties":false}},"required":["clips","bounds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createClips","summary":"Create clips","description":"Create clips.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"object","properties":{"source_type":{"default":"asset","type":"string","enum":["asset","youtube"]},"asset_id":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"youtube_url":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"default":null,"anyOf":[{"type":"string","enum":["720p","1080p","1440p","2160p"]},{"type":"null"}]}}},"clip_preset_id":{"default":"default","anyOf":[{"type":"string","enum":["default","formation-clipperz","demo-focus","high-retention"]},{"type":"null"}]},"caption_theme_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"max_clip_count":{"default":null,"anyOf":[{"type":"integer","minimum":1,"maximum":30},{"type":"null"}]},"studio_sound":{"type":"boolean"},"create_flow_options":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"branding_options":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["source"]},"example":{"project_name":"MKBHD hero loop","source":{"source_type":"youtube","youtube_url":"https://www.youtube.com/watch?v=VIDEO_ID","quality":"2160p"},"selection":{"selection_mode":"auto_best"},"target":{"aspect_ratio":"9:16","min_duration_seconds":8,"max_duration_seconds":12},"layout":{"layout_mode":"auto","content_type_hint":"podcast"},"captions":{"enabled":true},"qa":{"qa_mode":"permissive"},"export":{"auto_export":false}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"batch_id":{"type":"string"},"status":{"type":"string"},"asset_id":{"type":"string"},"project_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_clip_count":{"type":"number"},"total_clip_count":{"type":"number"},"rendered_count":{"type":"number"},"failed_count":{"type":"number"},"review_count":{"type":"number"},"activity":{},"clips":{"type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"status":{"type":"string"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_preview_urls":{"type":"array","items":{"type":"string"}}},"required":["clip_id","suggestion_id","project_id","export_id","title","status","download_url","error_message","qa_summary","qa_preview_urls"],"additionalProperties":false}},"zip_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"studio_sound":{"type":"object","properties":{"requested":{"type":"boolean"},"status":{"type":"string","enum":["disabled","pending","processing","applied","failed"]},"source_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"enhanced_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requested","status","source_asset_id","enhanced_asset_id","version","processing_run_id","error_message"],"additionalProperties":false}},"required":["batch_id","status","asset_id","project_folder_id","estimated_clip_count","total_clip_count","rendered_count","failed_count","review_count","activity","clips","zip_download_url","last_error_message","studio_sound"],"additionalProperties":false}},"required":["batch"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/clips/{clip_id}":{"get":{"operationId":"getClipsClipId","summary":"Get a clip","description":"Get a clip.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"clip":{"type":"object","properties":{"clip_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_project_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_clip_preset_id":{"anyOf":[{"type":"string","enum":["default","formation-clipperz","demo-focus","high-retention"]},{"type":"null"}]},"status":{"type":"string","enum":["preparing_source","awaiting_suggestions","selecting_clip","assembling","qa_running","needs_reselection","needs_repair","ready","exporting","exported","failed"]},"next_action":{"type":"string","enum":["poll","reselect","repair","export","stop"]},"error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"blocking_error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"waiting_reason":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"status_detail":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"object","properties":{"source_type":{"type":"string","enum":["asset","youtube"]},"asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"youtube_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_status":{"type":"string","enum":["pending","ready","failed"]},"transcript_status":{"type":"string","enum":["pending","ready","failed"]},"suggestions_status":{"type":"string","enum":["pending","ready","failed"]},"suggestion_counts":{"type":"object","properties":{"saved":{"type":"integer","minimum":0,"maximum":9007199254740991},"drafts":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["saved","drafts","total"],"additionalProperties":false},"suggestion_ai_run_ids":{"type":"array","items":{"type":"string"}},"analysis_status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"processing":{"type":"object","properties":{"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false}},"required":["processing_status","processing_substage","processing_error","processing_errors","processing_attempts","retryable","provider_request_ids"],"additionalProperties":false},"suitability":{"type":"object","properties":{"verdict":{"type":"string","enum":["ready","pending","failed","needs_reselection"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryable":{"type":"boolean"}},"required":["verdict","reason","retryable"],"additionalProperties":false},"readiness_warnings":{"type":"array","items":{"type":"string"}}},"required":["source_type","asset_id","youtube_url","source_status","transcript_status","suggestions_status","suggestion_counts","suggestion_ai_run_ids","analysis_status","analysis_version","canonical_duration_seconds","processing","suitability","readiness_warnings"],"additionalProperties":false},"selection":{"type":"object","properties":{"selection_mode":{"type":"string","enum":["auto_best","suggestion","time_range"]},"requested_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"applied_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alternatives":{"type":"array","items":{"type":"object","properties":{"suggestion_id":{"type":"string"},"title":{"type":"string"},"hook":{"type":"string"},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"score":{"type":"number"}},"required":["suggestion_id","title","hook","start_seconds","end_seconds","duration_seconds","score"],"additionalProperties":false}}},"required":["selection_mode","requested_suggestion_id","applied_suggestion_id","alternatives"],"additionalProperties":false},"clip_window":{"type":"object","properties":{"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["start_seconds","end_seconds","duration_seconds"],"additionalProperties":false},"layout":{"type":"object","properties":{"requested_mode":{"type":"string","enum":["auto","people_first","screen_first","preserve_full_source","prefer_split","prefer_focus","prefer_tutorial","prefer_demo"]},"tutorial_stack_ratio":{"type":"string","enum":["screen_70_face_30","screen_50_face_50"]},"applied_mode":{"type":"string","enum":["split","focus","letterbox","fullscreen","unknown"]},"primary_layout":{"anyOf":[{"type":"string"},{"type":"null"}]},"speaker_aware_applied":{"type":"boolean"},"fallback_used":{"type":"boolean"},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_mode_honored":{"type":"boolean"},"segments":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"layout_key":{"type":"string"},"caption_placement":{"type":"string","enum":["between_speakers","default"]},"panels":{"type":"array","items":{"type":"object","properties":{"track_asset_id":{"type":"string"},"role":{"type":"string","enum":["speaker","share","unknown"]},"canvas":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["x","y","width","height"],"additionalProperties":false},"source_crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]}},"required":["track_asset_id","role","canvas","source_crop","fit_mode"],"additionalProperties":false}}},"required":["start_seconds","end_seconds","duration_seconds","layout_key","caption_placement","panels"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["requested_mode","tutorial_stack_ratio","applied_mode","primary_layout","speaker_aware_applied","fallback_used","fallback_reason","requested_mode_honored","segments","warnings"],"additionalProperties":false},"captions":{"type":"object","properties":{"enabled":{"type":"boolean"},"style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_reveal_animation":{"anyOf":[{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},{"type":"null"}]},"max_lines_per_caption":{"anyOf":[{"type":"integer","minimum":1,"maximum":4},{"type":"null"}]},"words_per_line_limit":{"anyOf":[{"type":"integer","minimum":1,"maximum":16},{"type":"null"}]},"page_combine_ms":{"anyOf":[{"type":"integer","minimum":250,"maximum":10000},{"type":"null"}]},"status":{"type":"string","enum":["pending","ready","failed"]},"clip_window_aware":{"type":"boolean"},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"required":["enabled","style_id","word_reveal_animation","max_lines_per_caption","words_per_line_limit","page_combine_ms","status","clip_window_aware","item_count","warnings"],"additionalProperties":false},"qa":{"type":"object","properties":{"required":{"type":"boolean"},"status":{"type":"string","enum":["pending","passed","failed","bypassed"]},"blocking":{"type":"boolean"},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"code":{"type":"string"},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","code","title","details","suggested_fix"],"additionalProperties":false}},"preview_urls":{"type":"array","items":{"type":"string"}},"visual_debug_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["required","status","blocking","score","summary","issues","preview_urls","visual_debug_url"],"additionalProperties":false},"export":{"type":"object","properties":{"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","export_id","download_url","short_download_url"],"additionalProperties":false},"delivery":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"replacement_pending":{"type":"boolean"}},"required":["project_id","export_id","status","download_url","short_download_url","replacement_pending"],"additionalProperties":false},"request_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["clip_id","project_id","requested_project_name","requested_clip_preset_id","status","next_action","error","blocking_error","waiting_reason","status_detail","source","selection","clip_window","layout","captions","qa","export","delivery","request_id","created_at","updated_at"],"additionalProperties":false},"repair":{"anyOf":[{"type":"object","properties":{"applied":{"type":"boolean"},"repair_mode":{"default":"auto","type":"string","enum":["auto","prefer_split","prefer_focus","prefer_tutorial","prefer_demo","move_captions_off_faces"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_blocking_before":{"type":"boolean"},"qa_blocking_after":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["applied","repair_mode","reason","previous_timeline_item_id","next_timeline_item_id","qa_blocking_before","qa_blocking_after","warnings"],"additionalProperties":false},{"type":"null"}]}},"required":["clip","repair"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteClipsClipId","summary":"Delete a clip","description":"Deletes the clip record. The linked project and any completed export are kept and stay reachable from the projects list; delete them separately if needed.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","const":true},"clip_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["deleted","clip_id","project_id","export_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips/{clip_id}/reselect":{"post":{"operationId":"createClipsClipIdReselect","summary":"Reselect a clip","description":"Reselect a clip.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"selection":{"type":"object","properties":{"selection_mode":{"type":"string","enum":["auto_best","suggestion","time_range"]},"suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"target":{"anyOf":[{"type":"object","properties":{"aspect_ratio":{"default":"9:16","type":"string","enum":["9:16"]},"min_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_duration_seconds":{"default":50,"type":"number","minimum":1,"maximum":180}}},{"type":"null"}]},"layout":{"default":null,"anyOf":[{"type":"object","properties":{"layout_mode":{"type":"string","enum":["auto","people_first","screen_first","preserve_full_source","prefer_split","prefer_focus","prefer_tutorial","prefer_demo"]},"content_type_hint":{"type":"string","enum":["auto","podcast","tutorial","demo","generic"]},"tutorial_stack_ratio":{"type":"string","enum":["screen_70_face_30","screen_50_face_50"]}}},{"type":"null"}]},"captions":{"default":null,"anyOf":[{"type":"object","properties":{"enabled":{"type":"boolean"},"style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_reveal_animation":{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},"max_lines_per_caption":{"type":"integer","minimum":1,"maximum":4},"words_per_line_limit":{"anyOf":[{"type":"integer","minimum":1,"maximum":16},{"type":"null"}]},"page_combine_ms":{"type":"integer","minimum":250,"maximum":10000}}},{"type":"null"}]}}},"example":{"selection":{"selection_mode":"time_range","start_seconds":52,"end_seconds":64},"target":{"min_duration_seconds":8,"max_duration_seconds":12}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"clip":{"type":"object","properties":{"clip_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_project_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_clip_preset_id":{"anyOf":[{"type":"string","enum":["default","formation-clipperz","demo-focus","high-retention"]},{"type":"null"}]},"status":{"type":"string","enum":["preparing_source","awaiting_suggestions","selecting_clip","assembling","qa_running","needs_reselection","needs_repair","ready","exporting","exported","failed"]},"next_action":{"type":"string","enum":["poll","reselect","repair","export","stop"]},"error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"blocking_error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"waiting_reason":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"status_detail":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"object","properties":{"source_type":{"type":"string","enum":["asset","youtube"]},"asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"youtube_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_status":{"type":"string","enum":["pending","ready","failed"]},"transcript_status":{"type":"string","enum":["pending","ready","failed"]},"suggestions_status":{"type":"string","enum":["pending","ready","failed"]},"suggestion_counts":{"type":"object","properties":{"saved":{"type":"integer","minimum":0,"maximum":9007199254740991},"drafts":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["saved","drafts","total"],"additionalProperties":false},"suggestion_ai_run_ids":{"type":"array","items":{"type":"string"}},"analysis_status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"processing":{"type":"object","properties":{"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false}},"required":["processing_status","processing_substage","processing_error","processing_errors","processing_attempts","retryable","provider_request_ids"],"additionalProperties":false},"suitability":{"type":"object","properties":{"verdict":{"type":"string","enum":["ready","pending","failed","needs_reselection"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryable":{"type":"boolean"}},"required":["verdict","reason","retryable"],"additionalProperties":false},"readiness_warnings":{"type":"array","items":{"type":"string"}}},"required":["source_type","asset_id","youtube_url","source_status","transcript_status","suggestions_status","suggestion_counts","suggestion_ai_run_ids","analysis_status","analysis_version","canonical_duration_seconds","processing","suitability","readiness_warnings"],"additionalProperties":false},"selection":{"type":"object","properties":{"selection_mode":{"type":"string","enum":["auto_best","suggestion","time_range"]},"requested_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"applied_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alternatives":{"type":"array","items":{"type":"object","properties":{"suggestion_id":{"type":"string"},"title":{"type":"string"},"hook":{"type":"string"},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"score":{"type":"number"}},"required":["suggestion_id","title","hook","start_seconds","end_seconds","duration_seconds","score"],"additionalProperties":false}}},"required":["selection_mode","requested_suggestion_id","applied_suggestion_id","alternatives"],"additionalProperties":false},"clip_window":{"type":"object","properties":{"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["start_seconds","end_seconds","duration_seconds"],"additionalProperties":false},"layout":{"type":"object","properties":{"requested_mode":{"type":"string","enum":["auto","people_first","screen_first","preserve_full_source","prefer_split","prefer_focus","prefer_tutorial","prefer_demo"]},"tutorial_stack_ratio":{"type":"string","enum":["screen_70_face_30","screen_50_face_50"]},"applied_mode":{"type":"string","enum":["split","focus","letterbox","fullscreen","unknown"]},"primary_layout":{"anyOf":[{"type":"string"},{"type":"null"}]},"speaker_aware_applied":{"type":"boolean"},"fallback_used":{"type":"boolean"},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_mode_honored":{"type":"boolean"},"segments":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"layout_key":{"type":"string"},"caption_placement":{"type":"string","enum":["between_speakers","default"]},"panels":{"type":"array","items":{"type":"object","properties":{"track_asset_id":{"type":"string"},"role":{"type":"string","enum":["speaker","share","unknown"]},"canvas":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["x","y","width","height"],"additionalProperties":false},"source_crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]}},"required":["track_asset_id","role","canvas","source_crop","fit_mode"],"additionalProperties":false}}},"required":["start_seconds","end_seconds","duration_seconds","layout_key","caption_placement","panels"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["requested_mode","tutorial_stack_ratio","applied_mode","primary_layout","speaker_aware_applied","fallback_used","fallback_reason","requested_mode_honored","segments","warnings"],"additionalProperties":false},"captions":{"type":"object","properties":{"enabled":{"type":"boolean"},"style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_reveal_animation":{"anyOf":[{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},{"type":"null"}]},"max_lines_per_caption":{"anyOf":[{"type":"integer","minimum":1,"maximum":4},{"type":"null"}]},"words_per_line_limit":{"anyOf":[{"type":"integer","minimum":1,"maximum":16},{"type":"null"}]},"page_combine_ms":{"anyOf":[{"type":"integer","minimum":250,"maximum":10000},{"type":"null"}]},"status":{"type":"string","enum":["pending","ready","failed"]},"clip_window_aware":{"type":"boolean"},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"required":["enabled","style_id","word_reveal_animation","max_lines_per_caption","words_per_line_limit","page_combine_ms","status","clip_window_aware","item_count","warnings"],"additionalProperties":false},"qa":{"type":"object","properties":{"required":{"type":"boolean"},"status":{"type":"string","enum":["pending","passed","failed","bypassed"]},"blocking":{"type":"boolean"},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"code":{"type":"string"},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","code","title","details","suggested_fix"],"additionalProperties":false}},"preview_urls":{"type":"array","items":{"type":"string"}},"visual_debug_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["required","status","blocking","score","summary","issues","preview_urls","visual_debug_url"],"additionalProperties":false},"export":{"type":"object","properties":{"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","export_id","download_url","short_download_url"],"additionalProperties":false},"delivery":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"replacement_pending":{"type":"boolean"}},"required":["project_id","export_id","status","download_url","short_download_url","replacement_pending"],"additionalProperties":false},"request_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["clip_id","project_id","requested_project_name","requested_clip_preset_id","status","next_action","error","blocking_error","waiting_reason","status_detail","source","selection","clip_window","layout","captions","qa","export","delivery","request_id","created_at","updated_at"],"additionalProperties":false},"repair":{"anyOf":[{"type":"object","properties":{"applied":{"type":"boolean"},"repair_mode":{"default":"auto","type":"string","enum":["auto","prefer_split","prefer_focus","prefer_tutorial","prefer_demo","move_captions_off_faces"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_blocking_before":{"type":"boolean"},"qa_blocking_after":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["applied","repair_mode","reason","previous_timeline_item_id","next_timeline_item_id","qa_blocking_before","qa_blocking_after","warnings"],"additionalProperties":false},{"type":"null"}]}},"required":["clip","repair"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips/{clip_id}/repair":{"post":{"operationId":"createClipsClipIdRepair","summary":"Repair a clip","description":"Repair a clip.","tags":["Clip Creation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"repair_mode":{"default":"auto","type":"string","enum":["auto","prefer_split","prefer_focus","prefer_tutorial","prefer_demo","move_captions_off_faces"]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"clip":{"type":"object","properties":{"clip_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_project_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_clip_preset_id":{"anyOf":[{"type":"string","enum":["default","formation-clipperz","demo-focus","high-retention"]},{"type":"null"}]},"status":{"type":"string","enum":["preparing_source","awaiting_suggestions","selecting_clip","assembling","qa_running","needs_reselection","needs_repair","ready","exporting","exported","failed"]},"next_action":{"type":"string","enum":["poll","reselect","repair","export","stop"]},"error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"blocking_error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"waiting_reason":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"status_detail":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"object","properties":{"source_type":{"type":"string","enum":["asset","youtube"]},"asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"youtube_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_status":{"type":"string","enum":["pending","ready","failed"]},"transcript_status":{"type":"string","enum":["pending","ready","failed"]},"suggestions_status":{"type":"string","enum":["pending","ready","failed"]},"suggestion_counts":{"type":"object","properties":{"saved":{"type":"integer","minimum":0,"maximum":9007199254740991},"drafts":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["saved","drafts","total"],"additionalProperties":false},"suggestion_ai_run_ids":{"type":"array","items":{"type":"string"}},"analysis_status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"processing":{"type":"object","properties":{"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false}},"required":["processing_status","processing_substage","processing_error","processing_errors","processing_attempts","retryable","provider_request_ids"],"additionalProperties":false},"suitability":{"type":"object","properties":{"verdict":{"type":"string","enum":["ready","pending","failed","needs_reselection"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryable":{"type":"boolean"}},"required":["verdict","reason","retryable"],"additionalProperties":false},"readiness_warnings":{"type":"array","items":{"type":"string"}}},"required":["source_type","asset_id","youtube_url","source_status","transcript_status","suggestions_status","suggestion_counts","suggestion_ai_run_ids","analysis_status","analysis_version","canonical_duration_seconds","processing","suitability","readiness_warnings"],"additionalProperties":false},"selection":{"type":"object","properties":{"selection_mode":{"type":"string","enum":["auto_best","suggestion","time_range"]},"requested_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"applied_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alternatives":{"type":"array","items":{"type":"object","properties":{"suggestion_id":{"type":"string"},"title":{"type":"string"},"hook":{"type":"string"},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"score":{"type":"number"}},"required":["suggestion_id","title","hook","start_seconds","end_seconds","duration_seconds","score"],"additionalProperties":false}}},"required":["selection_mode","requested_suggestion_id","applied_suggestion_id","alternatives"],"additionalProperties":false},"clip_window":{"type":"object","properties":{"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["start_seconds","end_seconds","duration_seconds"],"additionalProperties":false},"layout":{"type":"object","properties":{"requested_mode":{"type":"string","enum":["auto","people_first","screen_first","preserve_full_source","prefer_split","prefer_focus","prefer_tutorial","prefer_demo"]},"tutorial_stack_ratio":{"type":"string","enum":["screen_70_face_30","screen_50_face_50"]},"applied_mode":{"type":"string","enum":["split","focus","letterbox","fullscreen","unknown"]},"primary_layout":{"anyOf":[{"type":"string"},{"type":"null"}]},"speaker_aware_applied":{"type":"boolean"},"fallback_used":{"type":"boolean"},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_mode_honored":{"type":"boolean"},"segments":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"layout_key":{"type":"string"},"caption_placement":{"type":"string","enum":["between_speakers","default"]},"panels":{"type":"array","items":{"type":"object","properties":{"track_asset_id":{"type":"string"},"role":{"type":"string","enum":["speaker","share","unknown"]},"canvas":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["x","y","width","height"],"additionalProperties":false},"source_crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]}},"required":["track_asset_id","role","canvas","source_crop","fit_mode"],"additionalProperties":false}}},"required":["start_seconds","end_seconds","duration_seconds","layout_key","caption_placement","panels"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["requested_mode","tutorial_stack_ratio","applied_mode","primary_layout","speaker_aware_applied","fallback_used","fallback_reason","requested_mode_honored","segments","warnings"],"additionalProperties":false},"captions":{"type":"object","properties":{"enabled":{"type":"boolean"},"style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_reveal_animation":{"anyOf":[{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},{"type":"null"}]},"max_lines_per_caption":{"anyOf":[{"type":"integer","minimum":1,"maximum":4},{"type":"null"}]},"words_per_line_limit":{"anyOf":[{"type":"integer","minimum":1,"maximum":16},{"type":"null"}]},"page_combine_ms":{"anyOf":[{"type":"integer","minimum":250,"maximum":10000},{"type":"null"}]},"status":{"type":"string","enum":["pending","ready","failed"]},"clip_window_aware":{"type":"boolean"},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"required":["enabled","style_id","word_reveal_animation","max_lines_per_caption","words_per_line_limit","page_combine_ms","status","clip_window_aware","item_count","warnings"],"additionalProperties":false},"qa":{"type":"object","properties":{"required":{"type":"boolean"},"status":{"type":"string","enum":["pending","passed","failed","bypassed"]},"blocking":{"type":"boolean"},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"code":{"type":"string"},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","code","title","details","suggested_fix"],"additionalProperties":false}},"preview_urls":{"type":"array","items":{"type":"string"}},"visual_debug_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["required","status","blocking","score","summary","issues","preview_urls","visual_debug_url"],"additionalProperties":false},"export":{"type":"object","properties":{"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","export_id","download_url","short_download_url"],"additionalProperties":false},"delivery":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"replacement_pending":{"type":"boolean"}},"required":["project_id","export_id","status","download_url","short_download_url","replacement_pending"],"additionalProperties":false},"request_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["clip_id","project_id","requested_project_name","requested_clip_preset_id","status","next_action","error","blocking_error","waiting_reason","status_detail","source","selection","clip_window","layout","captions","qa","export","delivery","request_id","created_at","updated_at"],"additionalProperties":false},"repair":{"anyOf":[{"type":"object","properties":{"applied":{"type":"boolean"},"repair_mode":{"default":"auto","type":"string","enum":["auto","prefer_split","prefer_focus","prefer_tutorial","prefer_demo","move_captions_off_faces"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_blocking_before":{"type":"boolean"},"qa_blocking_after":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["applied","repair_mode","reason","previous_timeline_item_id","next_timeline_item_id","qa_blocking_before","qa_blocking_after","warnings"],"additionalProperties":false},{"type":"null"}]}},"required":["clip","repair"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/clips/{clip_id}/export":{"post":{"operationId":"createClipsClipIdExport","summary":"Export a clip","description":"Export a clip.","tags":["Exports and Jobs"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"clip_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resolution":{"default":"1080p","type":"string","enum":["720p","1080p"]},"format":{"default":"mp4","type":"string","enum":["mp4","mov"]},"cover_frame_seconds":{"description":"Optional thumbnail frame timestamp in clip timeline seconds. Omit or pass null to use smart automatic selection.","anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"allow_blocking_qa_bypass":{"default":false,"type":"boolean"}}},"example":{"resolution":"1080p","format":"mp4","allow_blocking_qa_bypass":true}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"clip":{"type":"object","properties":{"clip_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_project_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_clip_preset_id":{"anyOf":[{"type":"string","enum":["default","formation-clipperz","demo-focus","high-retention"]},{"type":"null"}]},"status":{"type":"string","enum":["preparing_source","awaiting_suggestions","selecting_clip","assembling","qa_running","needs_reselection","needs_repair","ready","exporting","exported","failed"]},"next_action":{"type":"string","enum":["poll","reselect","repair","export","stop"]},"error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"blocking_error":{"anyOf":[{"type":"object","properties":{"step":{"type":"string","enum":["source","transcript","suggestions","selection","analysis","assembly","qa","repair","export"]},"code":{"type":"string"},"message":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected":{"anyOf":[{"type":"string"},{"type":"null"}]},"why_failed":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"type":"array","items":{"type":"string"}},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"},"upstream":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["clips_api","workspace_media","visual_qa","remotion_lambda","trigger_dev"]},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","job_id","export_id","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["step","code","message","detail","expected","why_failed","how_to_fix","retryable","retry_same_input","upstream"],"additionalProperties":false},{"type":"null"}]},"waiting_reason":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"status_detail":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"retry_same_input":{"type":"boolean"}},"required":["code","message","retryable","retry_same_input"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"object","properties":{"source_type":{"type":"string","enum":["asset","youtube"]},"asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"youtube_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_status":{"type":"string","enum":["pending","ready","failed"]},"transcript_status":{"type":"string","enum":["pending","ready","failed"]},"suggestions_status":{"type":"string","enum":["pending","ready","failed"]},"suggestion_counts":{"type":"object","properties":{"saved":{"type":"integer","minimum":0,"maximum":9007199254740991},"drafts":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["saved","drafts","total"],"additionalProperties":false},"suggestion_ai_run_ids":{"type":"array","items":{"type":"string"}},"analysis_status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"processing":{"type":"object","properties":{"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false}},"required":["processing_status","processing_substage","processing_error","processing_errors","processing_attempts","retryable","provider_request_ids"],"additionalProperties":false},"suitability":{"type":"object","properties":{"verdict":{"type":"string","enum":["ready","pending","failed","needs_reselection"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryable":{"type":"boolean"}},"required":["verdict","reason","retryable"],"additionalProperties":false},"readiness_warnings":{"type":"array","items":{"type":"string"}}},"required":["source_type","asset_id","youtube_url","source_status","transcript_status","suggestions_status","suggestion_counts","suggestion_ai_run_ids","analysis_status","analysis_version","canonical_duration_seconds","processing","suitability","readiness_warnings"],"additionalProperties":false},"selection":{"type":"object","properties":{"selection_mode":{"type":"string","enum":["auto_best","suggestion","time_range"]},"requested_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"applied_suggestion_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alternatives":{"type":"array","items":{"type":"object","properties":{"suggestion_id":{"type":"string"},"title":{"type":"string"},"hook":{"type":"string"},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"score":{"type":"number"}},"required":["suggestion_id","title","hook","start_seconds","end_seconds","duration_seconds","score"],"additionalProperties":false}}},"required":["selection_mode","requested_suggestion_id","applied_suggestion_id","alternatives"],"additionalProperties":false},"clip_window":{"type":"object","properties":{"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["start_seconds","end_seconds","duration_seconds"],"additionalProperties":false},"layout":{"type":"object","properties":{"requested_mode":{"type":"string","enum":["auto","people_first","screen_first","preserve_full_source","prefer_split","prefer_focus","prefer_tutorial","prefer_demo"]},"tutorial_stack_ratio":{"type":"string","enum":["screen_70_face_30","screen_50_face_50"]},"applied_mode":{"type":"string","enum":["split","focus","letterbox","fullscreen","unknown"]},"primary_layout":{"anyOf":[{"type":"string"},{"type":"null"}]},"speaker_aware_applied":{"type":"boolean"},"fallback_used":{"type":"boolean"},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requested_mode_honored":{"type":"boolean"},"segments":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"layout_key":{"type":"string"},"caption_placement":{"type":"string","enum":["between_speakers","default"]},"panels":{"type":"array","items":{"type":"object","properties":{"track_asset_id":{"type":"string"},"role":{"type":"string","enum":["speaker","share","unknown"]},"canvas":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["x","y","width","height"],"additionalProperties":false},"source_crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]}},"required":["track_asset_id","role","canvas","source_crop","fit_mode"],"additionalProperties":false}}},"required":["start_seconds","end_seconds","duration_seconds","layout_key","caption_placement","panels"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["requested_mode","tutorial_stack_ratio","applied_mode","primary_layout","speaker_aware_applied","fallback_used","fallback_reason","requested_mode_honored","segments","warnings"],"additionalProperties":false},"captions":{"type":"object","properties":{"enabled":{"type":"boolean"},"style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_reveal_animation":{"anyOf":[{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},{"type":"null"}]},"max_lines_per_caption":{"anyOf":[{"type":"integer","minimum":1,"maximum":4},{"type":"null"}]},"words_per_line_limit":{"anyOf":[{"type":"integer","minimum":1,"maximum":16},{"type":"null"}]},"page_combine_ms":{"anyOf":[{"type":"integer","minimum":250,"maximum":10000},{"type":"null"}]},"status":{"type":"string","enum":["pending","ready","failed"]},"clip_window_aware":{"type":"boolean"},"item_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"required":["enabled","style_id","word_reveal_animation","max_lines_per_caption","words_per_line_limit","page_combine_ms","status","clip_window_aware","item_count","warnings"],"additionalProperties":false},"qa":{"type":"object","properties":{"required":{"type":"boolean"},"status":{"type":"string","enum":["pending","passed","failed","bypassed"]},"blocking":{"type":"boolean"},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"code":{"type":"string"},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","code","title","details","suggested_fix"],"additionalProperties":false}},"preview_urls":{"type":"array","items":{"type":"string"}},"visual_debug_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["required","status","blocking","score","summary","issues","preview_urls","visual_debug_url"],"additionalProperties":false},"export":{"type":"object","properties":{"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","export_id","download_url","short_download_url"],"additionalProperties":false},"delivery":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["not_started","exporting","ready","failed"]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"replacement_pending":{"type":"boolean"}},"required":["project_id","export_id","status","download_url","short_download_url","replacement_pending"],"additionalProperties":false},"request_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["clip_id","project_id","requested_project_name","requested_clip_preset_id","status","next_action","error","blocking_error","waiting_reason","status_detail","source","selection","clip_window","layout","captions","qa","export","delivery","request_id","created_at","updated_at"],"additionalProperties":false},"repair":{"anyOf":[{"type":"object","properties":{"applied":{"type":"boolean"},"repair_mode":{"default":"auto","type":"string","enum":["auto","prefer_split","prefer_focus","prefer_tutorial","prefer_demo","move_captions_off_faces"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"qa_blocking_before":{"type":"boolean"},"qa_blocking_after":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["applied","repair_mode","reason","previous_timeline_item_id","next_timeline_item_id","qa_blocking_before","qa_blocking_after","warnings"],"additionalProperties":false},{"type":"null"}]}},"required":["clip","repair"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{project_id}/captions/magic-emojis":{"post":{"operationId":"createProjectsProjectIdCaptionsMagicEmojis","summary":"Generate caption emoji accents","description":"Generate caption emoji accents.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"project_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"}},"required":["asset_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"asset_id":{"type":"string"},"status":{"type":"string","const":"queued"},"run_id":{"type":"string"}},"required":["project_id","asset_id","status","run_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/admin/recovery/{resource_type}/{resource_id}":{"get":{"operationId":"getAdminRecoveryResourceTypeResourceId","summary":"Inspect a workspace recovery resource","description":"Inspect a workspace recovery resource.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"resource_type","schema":{"type":"string","enum":["asset","clip-batch","export"]},"required":true},{"in":"path","name":"resource_id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"resource_type":{"type":"string","enum":["asset","clip-batch","export"]},"resource_id":{"type":"string"},"resource":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"related":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["resource_type","resource_id","resource","related"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/admin/recovery/{resource_type}/{resource_id}/execute":{"post":{"operationId":"createAdminRecoveryResourceTypeResourceIdExecute","summary":"Execute a workspace recovery action","description":"Execute a workspace recovery action.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"resource_type","schema":{"type":"string","enum":["asset","clip-batch","export"]},"required":true},{"in":"path","name":"resource_id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["recover","retry","reconcile","cleanup"]},"reason":{"type":"string","minLength":3,"maxLength":500},"dry_run":{"default":false,"type":"boolean"},"confirm_destructive":{"default":false,"type":"boolean"}},"required":["action","reason"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"resource_type":{"type":"string","enum":["asset","clip-batch","export"]},"resource_id":{"type":"string"},"action":{"type":"string","enum":["recover","retry","reconcile","cleanup"]},"dry_run":{"type":"boolean"},"result":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["success","resource_type","resource_id","action","dry_run","result"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/admin/recovery/{resource_type}/{resource_id}/trigger-runs":{"get":{"operationId":"getAdminRecoveryResourceTypeResourceIdTriggerRuns","summary":"List Trigger runs for a workspace recovery resource","description":"List Trigger runs for a workspace recovery resource.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"resource_type","schema":{"type":"string","enum":["asset","clip-batch","export"]},"required":true},{"in":"path","name":"resource_id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"task_identifier":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"cost_in_cents":{"type":"number"},"duration_ms":{"type":"number"},"created_at":{"type":"string"}},"required":["id","status","task_identifier","tags","cost_in_cents","duration_ms","created_at"],"additionalProperties":false}}},"required":["runs"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/admin/recovery/{resource_type}/{resource_id}/trigger-runs/{run_id}/cancel":{"post":{"operationId":"createAdminRecoveryResourceTypeResourceIdTriggerRunsRunIdCancel","summary":"Cancel one Trigger run for a workspace recovery resource","description":"Cancel one Trigger run for a workspace recovery resource.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"resource_type","schema":{"type":"string","enum":["asset","clip-batch","export"]},"required":true},{"in":"path","name":"resource_id","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"path","name":"run_id","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500},"confirm_destructive":{"default":false,"type":"boolean"}},"required":["reason"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"run_id":{"type":"string"},"status":{"type":"string"}},"required":["success","run_id","status"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects":{"post":{"operationId":"createProject","summary":"Create project","description":"Create project.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"aspect_ratio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]},"project_type":{"type":"string","enum":["video","carousel"]},"carousel_settings":{"type":"object","properties":{"platform":{"type":"string","enum":["tiktok","instagram"]},"safe_area_preset":{"type":"string","enum":["tiktok_9_16","instagram_4_5","instagram_1_1"]},"slide_count":{"type":"integer","minimum":1,"maximum":9007199254740991},"background_strategy":{"type":"string","enum":["solid","gradient","image","mixed"]},"export_formats":{"type":"array","items":{"type":"string","enum":["png","jpg","mp4"]}},"jpeg_quality":{"type":"integer","minimum":1,"maximum":100}}}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"status":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","description","aspect_ratio","status","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}},"get":{"operationId":"listProjects","summary":"List projects","description":"List projects.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":50}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"number","minimum":0,"maximum":100000}},{"in":"query","name":"search","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"type":"string","enum":["active","archived","all"]}},{"in":"query","name":"exclude_clip_projects","schema":{"type":"boolean"}},{"in":"query","name":"has_export","schema":{"type":"boolean"}},{"in":"query","name":"aspect_ratio","schema":{"type":"string","enum":["9:16","16:9","1:1","4:5"]}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["updated_at","created_at"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"status":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"timeline_summary":{"type":"object","properties":{"total_items":{"type":"number"},"duration_seconds":{"type":"number"}},"required":["total_items","duration_seconds"],"additionalProperties":false},"has_export":{"type":"boolean"}},"required":["id","name","description","aspect_ratio","status","created_at","updated_at","timeline_summary","has_export"],"additionalProperties":false}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"status":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"timeline_summary":{"type":"object","properties":{"total_items":{"type":"number"},"duration_seconds":{"type":"number"}},"required":["total_items","duration_seconds"],"additionalProperties":false},"has_export":{"type":"boolean"}},"required":["id","name","description","aspect_ratio","status","created_at","updated_at","timeline_summary","has_export"],"additionalProperties":false}},"count":{"type":"number"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_more":{"type":"boolean"}},"required":["projects","items","count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}":{"get":{"operationId":"getProject","summary":"Get project","description":"Get project.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"status":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"preview_video_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_video_start_seconds":{"type":"number"},"preview_video_end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"clip_duration_seconds":{"type":"number"},"preview_source_views":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"source_crop_x":{"type":"number"},"source_crop_y":{"type":"number"},"source_crop_width":{"type":"number"},"source_crop_height":{"type":"number"},"canvas_x":{"type":"number"},"canvas_y":{"type":"number"},"canvas_width":{"type":"number"},"canvas_height":{"type":"number"},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"planner_mode":{"type":"string"},"source_width":{"anyOf":[{"type":"number"},{"type":"null"}]},"source_height":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["timeline_item_id","source_crop_x","source_crop_y","source_crop_width","source_crop_height","canvas_x","canvas_y","canvas_width","canvas_height","fit_mode","planner_mode","source_width","source_height"],"additionalProperties":false}},"duration_seconds":{"type":"number"}},"required":["id","name","description","aspect_ratio","status","created_at","updated_at","revision","preview_video_url","preview_video_start_seconds","preview_video_end_seconds","clip_duration_seconds","preview_source_views","duration_seconds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateProject","summary":"Update project metadata","description":"Update project metadata.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"aspect_ratio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"status":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","description","aspect_ratio","status","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteProjectsProjectId","summary":"Delete project","description":"Delete project.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/preview-frame":{"post":{"operationId":"renderProjectPreviewFrame","summary":"Render one preview frame for a project","description":"Render one preview frame for a project.","tags":["Project Context"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"time_seconds":{"type":"number","minimum":0},"target_width":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"image_format":{"anyOf":[{"type":"string","enum":["jpeg","png"]},{"type":"null"}]}},"required":["time_seconds"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"preview_url":{"type":"string"},"expires_at":{"type":"string"},"storage_key":{"type":"string"},"captured_at":{"type":"string"},"cached":{"type":"boolean"},"frame":{"type":"number"},"time_seconds":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"image_format":{"type":"string","enum":["jpeg","png"]},"revision":{"type":"number"}},"required":["preview_url","expires_at","storage_key","captured_at","cached","frame","time_seconds","width","height","image_format","revision"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/preview-frames":{"post":{"operationId":"renderProjectPreviewFrames","summary":"Render multiple preview frames for a project","description":"Render multiple preview frames for a project.","tags":["Project Context"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"times_seconds":{"minItems":1,"type":"array","items":{"type":"number","minimum":0}},"time_seconds_list":{"minItems":1,"type":"array","items":{"type":"number","minimum":0}},"target_width":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"image_format":{"anyOf":[{"type":"string","enum":["jpeg","png"]},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"revision":{"type":"number"},"previews":{"type":"array","items":{"type":"object","properties":{"preview_url":{"type":"string"},"expires_at":{"type":"string"},"storage_key":{"type":"string"},"captured_at":{"type":"string"},"cached":{"type":"boolean"},"frame":{"type":"number"},"time_seconds":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"image_format":{"type":"string","enum":["jpeg","png"]},"revision":{"type":"number"}},"required":["preview_url","expires_at","storage_key","captured_at","cached","frame","time_seconds","width","height","image_format","revision"],"additionalProperties":false}}},"required":["project_id","revision","previews"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/visual-analysis":{"post":{"operationId":"createProjectsProjectIdVisualAnalysis","summary":"Render and visually analyze one or more project frames","description":"Render and visually analyze one or more project frames.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"time_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"times_seconds":{"anyOf":[{"type":"array","items":{"type":"number","minimum":0}},{"type":"null"}]},"target_width":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"image_format":{"anyOf":[{"type":"string","enum":["jpeg","png"]},{"type":"null"}]},"instruction":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["time_seconds","times_seconds","target_width","image_format","instruction"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"revision":{"type":"number"},"summary":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","title","details","suggested_fix"],"additionalProperties":false}},"suggested_next_edits":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"preview_url":{"type":"string"},"expires_at":{"type":"string"},"storage_key":{"type":"string"},"captured_at":{"type":"string"},"cached":{"type":"boolean"},"frame":{"type":"number"},"time_seconds":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"image_format":{"type":"string","enum":["jpeg","png"]},"revision":{"type":"number"},"analysis":{"type":"object","properties":{"summary":{"type":"string"},"visibleText":{"type":"array","items":{"type":"string"}},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"title":{"type":"string"},"details":{"type":"string"},"suggestedFix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","title","details","suggestedFix"],"additionalProperties":false}},"suggestedNextEdits":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"}},"required":["summary","visibleText","issues","suggestedNextEdits","confidence"],"additionalProperties":false}},"required":["preview_url","expires_at","storage_key","captured_at","cached","frame","time_seconds","width","height","image_format","revision","analysis"],"additionalProperties":false}}},"required":["project_id","revision","summary","issues","suggested_next_edits","confidence","frames"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/visual-debug":{"get":{"operationId":"getProjectsProjectIdVisualDebug","summary":"Return machine-readable visual layout debug data","description":"Return machine-readable visual layout debug data.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"time_seconds","schema":{"type":"number","minimum":0},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"revision":{"type":"number"},"captured_at":{"type":"string"},"cached":{"type":"boolean"},"layout_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"visible_media_rect":{"anyOf":[{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["left","top","width","height"],"additionalProperties":false},{"type":"null"}]},"visible_media_rects":{"type":"array","items":{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"timeline_item_id":{"type":"string"}},"required":["left","top","width","height","timeline_item_id"],"additionalProperties":false}},"caption_rects":{"type":"array","items":{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"timeline_item_id":{"type":"string"}},"required":["left","top","width","height","timeline_item_id"],"additionalProperties":false}},"canvas_rects":{"type":"array","items":{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"timeline_item_id":{"type":"string"}},"required":["left","top","width","height","timeline_item_id"],"additionalProperties":false}},"source_crops":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"planner_mode":{"type":"string"}},"required":["timeline_item_id","x","y","width","height","fit_mode","planner_mode"],"additionalProperties":false}},"speaker_regions":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"side":{"type":"string","enum":["left","right","center"]},"confidence":{"type":"number"},"coverage_ratio":{"type":"number"},"dominant_ratio":{"type":"number"},"box":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false}},"required":["asset_id","side","confidence","coverage_ratio","dominant_ratio","box"],"additionalProperties":false}},"face_boxes":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"subject_id":{"type":"string"},"label":{"type":"string"},"role":{"type":"string","enum":["primary","secondary"]},"side":{"type":"string","enum":["left","right","center"]},"confidence":{"type":"number"},"box":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false}},"required":["asset_id","subject_id","label","role","side","confidence","box"],"additionalProperties":false}},"active_split_gap_rect":{"anyOf":[{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["left","top","width","height"],"additionalProperties":false},{"type":"null"}]}},"required":["project_id","revision","captured_at","cached","layout_key","visible_media_rect","visible_media_rects","caption_rects","canvas_rects","source_crops","speaker_regions","face_boxes","active_split_gap_rect"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/media-views/items/{timelineItemId}":{"post":{"operationId":"createProjectsProjectIdTimelineMediaViewsItemsTimelineItemId","summary":"Upsert a public media view for a project timeline item","description":"Upsert a public media view for a project timeline item.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"source_asset_id":{"type":"string"},"source_start_units":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"source_end_units":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"source_crop_x":{"type":"number"},"source_crop_y":{"type":"number"},"source_crop_width":{"type":"number"},"source_crop_height":{"type":"number"},"canvas_x":{"type":"number"},"canvas_y":{"type":"number"},"canvas_width":{"type":"number"},"canvas_height":{"type":"number"},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"mask_shape":{"type":"string","enum":["none","rounded","circle"]},"mask_radius":{"type":"number"},"sync_group_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"planner_mode":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"planner_metadata":{"type":"object","properties":{"templateKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"analysisStatus":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysisVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallbackReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"repairApplied":{"default":false,"type":"boolean"},"dominantSpeakerSide":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"speakerCount":{"type":"number"},"stylePolicy":{"default":null,"anyOf":[{"type":"object","properties":{"schemaVersion":{"type":"number"},"styleId":{"type":"string","enum":["auto_default","product_demo","letterbox","speaker_focus","speaker_split","speaker_grid","webinar","gameplay","tutorial"]},"requestedContentTypeHint":{"type":"string","enum":["auto","podcast","tutorial","demo","generic"]},"requestedLayoutStrategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]},"fillPosture":{"type":"string","enum":["fill_portrait","preserve_screen","preserve_full_source"]},"fallbackPosture":{"type":"string","enum":["repair_then_safe_layout","preserve_screen","preserve_full_source"]},"safetyProfile":{"type":"string","enum":["speaker_subject","demo_subject","screen_safe","full_source"]},"targetPriority":{"type":"string","enum":["speaker","demo_object","screen","full_source"]},"allowedLayouts":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}}},"required":["schemaVersion","styleId","requestedContentTypeHint","requestedLayoutStrategy","fillPosture","fallbackPosture","safetyProfile","targetPriority","allowedLayouts"]},{"type":"null"}]},"decisionTrace":{"default":null,"anyOf":[{"type":"object","properties":{"schemaVersion":{"type":"number"},"styleId":{"type":"string","enum":["auto_default","product_demo","letterbox","speaker_focus","speaker_split","speaker_grid","webinar","gameplay","tutorial"]},"segmentKey":{"type":"string"},"candidateLayouts":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"records":{"type":"array","items":{"type":"object","properties":{"stage":{"type":"string","enum":["style","window","model_crop","speaker_aware","density","view_build","safety","metadata"]},"action":{"type":"string"},"layoutKey":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"fallbackReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}}},"required":["stage","action","layoutKey","fallbackReason","reason","metrics"]}}},"required":["schemaVersion","styleId","segmentKey","candidateLayouts","records"]},{"type":"null"}]}},"required":["templateKey","notes","analysisStatus","analysisVersion","confidence","fallbackReason","dominantSpeakerSide","speakerCount"]}},"required":["expected_revision","source_asset_id","source_start_units","source_end_units","source_crop_x","source_crop_y","source_crop_width","source_crop_height","canvas_x","canvas_y","canvas_width","canvas_height","fit_mode","mask_shape","mask_radius","sync_group_id","planner_mode","planner_metadata"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"txid":{"type":"number"},"base_revision":{"type":"number"},"revision":{"type":"number"},"media_view":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"source_asset_id":{"type":"string"},"source_start_units":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"source_end_units":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"source_crop_x":{"type":"number"},"source_crop_y":{"type":"number"},"source_crop_width":{"type":"number"},"source_crop_height":{"type":"number"},"canvas_x":{"type":"number"},"canvas_y":{"type":"number"},"canvas_width":{"type":"number"},"canvas_height":{"type":"number"},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"mask_shape":{"type":"string","enum":["none","rounded","circle"]},"mask_radius":{"type":"number"},"sync_group_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"planner_mode":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"planner_metadata":{"type":"object","properties":{"templateKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"analysisStatus":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysisVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallbackReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"repairApplied":{"default":false,"type":"boolean"},"dominantSpeakerSide":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"speakerCount":{"type":"number"},"stylePolicy":{"default":null,"anyOf":[{"type":"object","properties":{"schemaVersion":{"type":"number"},"styleId":{"type":"string","enum":["auto_default","product_demo","letterbox","speaker_focus","speaker_split","speaker_grid","webinar","gameplay","tutorial"]},"requestedContentTypeHint":{"type":"string","enum":["auto","podcast","tutorial","demo","generic"]},"requestedLayoutStrategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]},"fillPosture":{"type":"string","enum":["fill_portrait","preserve_screen","preserve_full_source"]},"fallbackPosture":{"type":"string","enum":["repair_then_safe_layout","preserve_screen","preserve_full_source"]},"safetyProfile":{"type":"string","enum":["speaker_subject","demo_subject","screen_safe","full_source"]},"targetPriority":{"type":"string","enum":["speaker","demo_object","screen","full_source"]},"allowedLayouts":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}}},"required":["schemaVersion","styleId","requestedContentTypeHint","requestedLayoutStrategy","fillPosture","fallbackPosture","safetyProfile","targetPriority","allowedLayouts"],"additionalProperties":false},{"type":"null"}]},"decisionTrace":{"default":null,"anyOf":[{"type":"object","properties":{"schemaVersion":{"type":"number"},"styleId":{"type":"string","enum":["auto_default","product_demo","letterbox","speaker_focus","speaker_split","speaker_grid","webinar","gameplay","tutorial"]},"segmentKey":{"type":"string"},"candidateLayouts":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"records":{"type":"array","items":{"type":"object","properties":{"stage":{"type":"string","enum":["style","window","model_crop","speaker_aware","density","view_build","safety","metadata"]},"action":{"type":"string"},"layoutKey":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"fallbackReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}}},"required":["stage","action","layoutKey","fallbackReason","reason","metrics"],"additionalProperties":false}}},"required":["schemaVersion","styleId","segmentKey","candidateLayouts","records"],"additionalProperties":false},{"type":"null"}]}},"required":["templateKey","notes","analysisStatus","analysisVersion","confidence","fallbackReason","repairApplied","dominantSpeakerSide","speakerCount","stylePolicy","decisionTrace"],"additionalProperties":false}},"required":["timeline_item_id","source_asset_id","source_start_units","source_end_units","source_crop_x","source_crop_y","source_crop_width","source_crop_height","canvas_x","canvas_y","canvas_width","canvas_height","fit_mode","mask_shape","mask_radius","sync_group_id","planner_mode","planner_metadata"],"additionalProperties":false}},"required":["success","txid","base_revision","revision","media_view"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/media-views/duplicate":{"post":{"operationId":"createProjectsProjectIdTimelineMediaViewsDuplicate","summary":"Duplicate a linked source view from one timeline item to another","description":"Duplicate a linked source view from one timeline item to another.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"source_timeline_item_id":{"type":"string"},"target_timeline_item_id":{"type":"string"},"sync_group_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["expected_revision","source_timeline_item_id","target_timeline_item_id","sync_group_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"txid":{"type":"number"},"base_revision":{"type":"number"},"revision":{"type":"number"},"media_view":{"anyOf":[{"type":"object","properties":{"timeline_item_id":{"type":"string"},"source_asset_id":{"type":"string"},"source_start_units":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"source_end_units":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"source_crop_x":{"type":"number"},"source_crop_y":{"type":"number"},"source_crop_width":{"type":"number"},"source_crop_height":{"type":"number"},"canvas_x":{"type":"number"},"canvas_y":{"type":"number"},"canvas_width":{"type":"number"},"canvas_height":{"type":"number"},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"mask_shape":{"type":"string","enum":["none","rounded","circle"]},"mask_radius":{"type":"number"},"sync_group_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"planner_mode":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"planner_metadata":{"type":"object","properties":{"templateKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"analysisStatus":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysisVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallbackReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"repairApplied":{"default":false,"type":"boolean"},"dominantSpeakerSide":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"speakerCount":{"type":"number"},"stylePolicy":{"default":null,"anyOf":[{"type":"object","properties":{"schemaVersion":{"type":"number"},"styleId":{"type":"string","enum":["auto_default","product_demo","letterbox","speaker_focus","speaker_split","speaker_grid","webinar","gameplay","tutorial"]},"requestedContentTypeHint":{"type":"string","enum":["auto","podcast","tutorial","demo","generic"]},"requestedLayoutStrategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]},"fillPosture":{"type":"string","enum":["fill_portrait","preserve_screen","preserve_full_source"]},"fallbackPosture":{"type":"string","enum":["repair_then_safe_layout","preserve_screen","preserve_full_source"]},"safetyProfile":{"type":"string","enum":["speaker_subject","demo_subject","screen_safe","full_source"]},"targetPriority":{"type":"string","enum":["speaker","demo_object","screen","full_source"]},"allowedLayouts":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}}},"required":["schemaVersion","styleId","requestedContentTypeHint","requestedLayoutStrategy","fillPosture","fallbackPosture","safetyProfile","targetPriority","allowedLayouts"],"additionalProperties":false},{"type":"null"}]},"decisionTrace":{"default":null,"anyOf":[{"type":"object","properties":{"schemaVersion":{"type":"number"},"styleId":{"type":"string","enum":["auto_default","product_demo","letterbox","speaker_focus","speaker_split","speaker_grid","webinar","gameplay","tutorial"]},"segmentKey":{"type":"string"},"candidateLayouts":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"records":{"type":"array","items":{"type":"object","properties":{"stage":{"type":"string","enum":["style","window","model_crop","speaker_aware","density","view_build","safety","metadata"]},"action":{"type":"string"},"layoutKey":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"fallbackReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"boolean"},{"type":"null"}]}}},"required":["stage","action","layoutKey","fallbackReason","reason","metrics"],"additionalProperties":false}}},"required":["schemaVersion","styleId","segmentKey","candidateLayouts","records"],"additionalProperties":false},{"type":"null"}]}},"required":["templateKey","notes","analysisStatus","analysisVersion","confidence","fallbackReason","repairApplied","dominantSpeakerSide","speakerCount","stylePolicy","decisionTrace"],"additionalProperties":false}},"required":["timeline_item_id","source_asset_id","source_start_units","source_end_units","source_crop_x","source_crop_y","source_crop_width","source_crop_height","canvas_x","canvas_y","canvas_width","canvas_height","fit_mode","mask_shape","mask_radius","sync_group_id","planner_mode","planner_metadata"],"additionalProperties":false},{"type":"null"}]}},"required":["success","txid","base_revision","revision","media_view"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/media":{"post":{"operationId":"createProjectsProjectIdMedia","summary":"Upload media","description":"Upload media.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storage_key":{"type":"string"},"content_hash_sha256":{"type":"string"},"file_name":{"type":"string"},"content_type":{"type":"string"},"file_size_bytes":{"type":"number"},"url":{"type":"string"},"name":{"type":"string"},"auto_process_enabled":{"type":"boolean"},"auto_transcribe":{"type":"boolean"},"auto_describe_after_transcribe":{"type":"boolean"},"auto_suggest_shorts":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"asset_type":{"type":"string"},"mime_type":{"type":"string"},"file_size_bytes":{"type":"number"},"processing_status":{"type":"string"},"created_at":{"type":"string"},"deduped":{"type":"boolean"}},"required":["id","name","asset_type","mime_type","file_size_bytes","processing_status","created_at","deduped"],"additionalProperties":false}},"required":["media"],"additionalProperties":false},{"type":"object","properties":{"upload":{"type":"object","properties":{"uploadUrl":{"type":"string"},"storageKey":{"type":"string"},"expiresIn":{"type":"number"},"instructions":{"type":"string"}},"required":["uploadUrl","storageKey","expiresIn","instructions"],"additionalProperties":false}},"required":["upload"],"additionalProperties":false}]}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"get":{"operationId":"getProjectsProjectIdMedia","summary":"List project media","description":"List project media.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"asset_type":{"type":"string"},"mime_type":{"type":"string"},"file_size_bytes":{"type":"number"},"processing_status":{"type":"string"},"created_at":{"type":"string"},"deduped":{"type":"boolean"}},"required":["id","name","asset_type","mime_type","file_size_bytes","processing_status","created_at","deduped"],"additionalProperties":false}}},"required":["media"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/media/{mediaId}":{"delete":{"operationId":"deleteProjectsProjectIdMediaMediaId","summary":"Delete project media","description":"Delete project media.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"mediaId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/recording-sets":{"get":{"operationId":"getRecordingSets","summary":"List Recording Sets","description":"List Recording Sets.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"status","schema":{"default":null,"anyOf":[{"type":"string","enum":["collecting_assets","analyzing","finalizing","ready","failed"]},{"type":"null"}]}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"offset","schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_sets":{"type":"array","items":{"type":"object","properties":{"recording_set_id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["collecting_assets","analyzing","finalizing","ready","failed"]},"media_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"anchor_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alignment_strategy":{"anyOf":[{"type":"string","enum":["padded","cross_correlation"]},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"alignment_confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"analysis_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"tracks":{"type":"array","items":{"type":"object","properties":{"track_id":{"type":"string"},"asset_id":{"type":"string"},"role":{"type":"string","enum":["camera","screen"]},"participant_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"participant_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_primary":{"type":"boolean"},"alignment_offset_seconds":{"type":"number"},"content_windows":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number"},"end_seconds":{"type":"number"}},"required":["start_seconds","end_seconds"],"additionalProperties":false}},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["track_id","asset_id","role","participant_label","participant_name","is_primary","alignment_offset_seconds","content_windows","order_index"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["recording_set_id","name","status","media_folder_id","anchor_asset_id","alignment_strategy","duration_seconds","alignment_confidence","warnings","analysis_error","tracks","created_at","updated_at"],"additionalProperties":false}},"bounds":{"type":"object","properties":{"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"returned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"has_more":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["limit","offset","total","returned","has_more","truncated"],"additionalProperties":false}},"required":["recording_sets","bounds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createRecordingSet","summary":"Create a synchronized Recording Set","description":"Create a synchronized Recording Set.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_set_id":{"type":"string"},"media_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","const":"collecting_assets"}},"required":["recording_set_id","media_folder_id","status"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/recording-sets/{recordingSetId}":{"get":{"operationId":"getRecordingSet","summary":"Get a Recording Set and its synchronized assets","description":"Get a Recording Set and its synchronized assets.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"recordingSetId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_set_id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["collecting_assets","analyzing","finalizing","ready","failed"]},"media_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"anchor_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"alignment_strategy":{"anyOf":[{"type":"string","enum":["padded","cross_correlation"]},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"alignment_confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"analysis_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"tracks":{"type":"array","items":{"type":"object","properties":{"track_id":{"type":"string"},"asset_id":{"type":"string"},"role":{"type":"string","enum":["camera","screen"]},"participant_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"participant_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_primary":{"type":"boolean"},"alignment_offset_seconds":{"type":"number"},"content_windows":{"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number"},"end_seconds":{"type":"number"}},"required":["start_seconds","end_seconds"],"additionalProperties":false}},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["track_id","asset_id","role","participant_label","participant_name","is_primary","alignment_offset_seconds","content_windows","order_index"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["recording_set_id","name","status","media_folder_id","anchor_asset_id","alignment_strategy","duration_seconds","alignment_confidence","warnings","analysis_error","tracks","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteRecordingSetsRecordingSetId","summary":"Delete an empty unfinalized Recording Set","description":"Delete an empty unfinalized Recording Set.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"recordingSetId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"query","name":"confirm_delete","schema":{"type":"boolean"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_set_id":{"type":"string"},"deleted":{"type":"boolean","const":true}},"required":["recording_set_id","deleted"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/recording-sets/{recordingSetId}/tracks":{"post":{"operationId":"attachRecordingSetTrack","summary":"Attach a camera or screen asset to a Recording Set","description":"Attach a camera or screen asset to a Recording Set.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"recordingSetId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"role":{"type":"string","enum":["camera","screen"]},"participant_label":{"default":null,"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"participant_name":{"default":null,"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"is_primary":{"default":false,"type":"boolean"}},"required":["asset_id","role"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_set_id":{"type":"string"},"track_id":{"type":"string"},"asset_id":{"type":"string"},"role":{"type":"string","enum":["camera","screen"]}},"required":["recording_set_id","track_id","asset_id","role"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/recording-sets/{recordingSetId}/finalize":{"post":{"operationId":"finalizeRecordingSet","summary":"Finalize assets and analyze a Recording Set","description":"Finalize assets and analyze a Recording Set.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"recordingSetId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_set_id":{"type":"string"},"status":{"type":"string","enum":["collecting_assets","analyzing","finalizing","ready","failed"]},"anchor_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["recording_set_id","status","anchor_asset_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/recording-sets/{recordingSetId}/clip-batches":{"post":{"operationId":"createRecordingSetClipBatch","summary":"Generate clips from an analyzed Recording Set","description":"Generate clips from an analyzed Recording Set.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"recordingSetId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clip_preset_id":{"default":"default","type":"string","enum":["default","formation-clipperz","high-retention","demo-focus"]},"create_flow_options":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"branding_options":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"max_clip_count":{"default":null,"anyOf":[{"type":"integer","minimum":1,"maximum":30},{"type":"null"}]},"max_duration_seconds":{"default":null,"anyOf":[{"anyOf":[{"type":"number","const":30},{"type":"number","const":60},{"type":"number","const":90},{"type":"number","const":180}]},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"recording_set_id":{"type":"string"},"batch_id":{"type":"string"},"project_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_clip_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"studio_sound":{"type":"object","properties":{"requested":{"type":"boolean"},"status":{"type":"string","enum":["disabled","pending","processing","applied","failed"]},"source_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"enhanced_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requested","status","source_asset_id","enhanced_asset_id","version","processing_run_id","error_message"],"additionalProperties":false}},"required":["recording_set_id","batch_id","project_folder_id","estimated_clip_count","studio_sound"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/transcribe":{"post":{"operationId":"createProjectsProjectIdTranscribe","summary":"Start transcription","description":"Start transcription.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","minLength":1},"force":{"type":"boolean"},"auto_suggest_shorts":{"type":"boolean"}},"required":["media_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"status":{"type":"string"},"estimated_seconds":{"type":"number"},"created_at":{"type":"string"}},"required":["job_id","status","estimated_seconds","created_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/transcript":{"get":{"operationId":"getProjectsProjectIdTranscript","summary":"Get transcript","description":"Get transcript.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"media_id","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string"},"assetName":{"type":"string"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationSeconds":{"type":"number"},"wordCount":{"type":"number"},"segmentCount":{"type":"number"},"averageConfidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullText":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"text":{"type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"speakerLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"speakerConfidence":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","startSeconds","endSeconds","text","confidence","speakerLabel","speakerConfidence"],"additionalProperties":false}}},"required":["assetId","assetName","language","durationSeconds","wordCount","segmentCount","averageConfidence","fullText","segments"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions":{"post":{"operationId":"createProjectsProjectIdCaptions","summary":"Apply caption style","description":"Apply caption style.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caption_style_id":{"type":"string"},"style_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"style_id":{"type":"string"},"name":{"type":"string"}},"required":["success","style_id","name"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"get":{"operationId":"getProjectsProjectIdCaptions","summary":"List captions","description":"List captions.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":100}},{"in":"query","name":"offset","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"captions":{"type":"array","items":{"type":"object","properties":{"caption_id":{"type":"string"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"project_id":{"type":"string"},"text":{"type":"string"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"paragraph_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_emphasis":{"type":"boolean"},"style":{"anyOf":[{"type":"object","properties":{"offsetX":{"anyOf":[{"type":"number"},{"type":"null"}]},"offsetY":{"anyOf":[{"type":"number"},{"type":"null"}]},"rotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"anyOf":[{"type":"number"},{"type":"null"}]},"fontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"fontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeAnimation":{"anyOf":[{"type":"string","enum":["none","slide-from-bottom","pop","glow","punch"]},{"type":"null"}]},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textTransform":{"anyOf":[{"type":"string","enum":["none","uppercase"]},{"type":"null"}]},"letterSpacing":{"anyOf":[{"type":"number"},{"type":"null"}]},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundRadiusPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emojiName":{"anyOf":[{"type":"string"},{"type":"null"}]},"emojiScale":{"anyOf":[{"type":"string","enum":["1","2","0.5"]},{"type":"null"}]},"isSpecial":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isKeyword":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units","start_seconds","end_seconds","paragraph_index","is_emphasis","style"],"additionalProperties":false}}},"required":["caption_id","timeline_item_id","project_id","text","start_units","end_units","start_seconds","end_seconds","words"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"total":{"type":"number"},"returned":{"type":"number"},"offset":{"type":"number"},"limit":{"type":"number"},"has_more":{"type":"boolean"}},"required":["total","returned","offset","limit","has_more"],"additionalProperties":false}},"required":["success","captions","pagination"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/styles":{"get":{"operationId":"getStyles","summary":"List caption styles","description":"List caption styles.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"poster_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","preview_url","poster_url"],"additionalProperties":false}}},"required":["styles"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/voices":{"get":{"operationId":"getVoices","summary":"List voices","description":"List voices.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"voices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"language":{"type":"string"},"gender":{"type":"string"},"accent":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"previewUrl":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["voices"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/visual-styles":{"get":{"operationId":"getVisualStyles","summary":"List visual styles","description":"List visual styles.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"visual_styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"aliases":{"type":"array","items":{"type":"string"}}},"required":["id","slug","name"],"additionalProperties":false}}},"required":["visual_styles"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/faceless/plans":{"post":{"operationId":"createProjectsProjectIdFacelessPlans","summary":"Create faceless production plan revision","description":"Requires an active paid plan. Creates an immutable generated-only 9:16 production plan. This planning call does not generate character anchors, keyframes, or video clips.\n\nCost note: This operation may consume AI credits and can take time to complete.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"script":{"type":"string","minLength":1,"maxLength":30000},"target_duration_seconds":{"type":"number","minimum":10,"maximum":120},"visual_style":{"type":"string","minLength":1,"maxLength":200},"story_kit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"planner_model_id":{"type":"string","minLength":3,"maxLength":200},"image_model_id":{"type":"string","minLength":3,"maxLength":200},"video_model":{"type":"string","minLength":3,"maxLength":200},"voice_id":{"type":"string","maxLength":200},"include_captions":{"type":"boolean"},"caption_style_id":{"type":"string","maxLength":200},"generate_background_music":{"type":"boolean"},"generate_sound_effects":{"type":"boolean"},"character_ids":{"maxItems":8,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["script"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"project_id":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["draft","plan_approved","preproduction_processing","awaiting_asset_approval","asset_approved","generating","complete","failed"]},"plan":{"type":"object","properties":{"version":{"type":"string","const":"faceless-production-plan-v1"},"productionProfile":{"type":"string","const":"dramatic_vertical_v1"},"visualMode":{"type":"string","const":"generated_only"},"plannerModelId":{"type":"string"},"imageModelId":{"type":"string"},"videoModelId":{"type":"string"},"aspectRatio":{"type":"string","const":"9:16"},"voiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"includeCaptions":{"type":"boolean"},"captionStyleId":{"anyOf":[{"type":"string"},{"type":"null"}]},"generateBackgroundMusic":{"type":"boolean"},"generateSoundEffects":{"type":"boolean"},"script":{"type":"string"},"storyKitSnapshot":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"story-kit-snapshot-v1"},"storyKitId":{"type":"string"},"revision":{"type":"number"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visualStyle":{"type":"string"},"styleReferenceAssetIds":{"type":"array","items":{"type":"string"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"canonicalDescription":{"type":"string"},"referenceAssetIds":{"type":"array","items":{"type":"string"}},"facts":{"type":"array","items":{"type":"string"}}},"required":["id","name","canonicalDescription","referenceAssetIds","facts"],"additionalProperties":false}},"narratorCharacterId":{"anyOf":[{"type":"string"},{"type":"null"}]},"characters":{"type":"array","items":{"type":"object","properties":{"characterId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonicalDescription":{"type":"string"},"storyFacts":{"type":"array","items":{"type":"string"}},"defaultVoiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultVoiceStyle":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryReferenceAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceAssetIds":{"type":"array","items":{"type":"string"}}},"required":["characterId","name","type","species","canonicalDescription","storyFacts","defaultVoiceId","defaultVoiceStyle","primaryReferenceAssetId","referenceAssetIds"],"additionalProperties":false}}},"required":["version","storyKitId","revision","name","description","visualStyle","styleReferenceAssetIds","facts","locations","narratorCharacterId","characters"],"additionalProperties":false},{"type":"null"}]},"styleAnchorPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"characters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"canonicalDescription":{"type":"string"},"anchorPrompt":{"type":"string"},"source":{"type":"string","enum":["generated","workspace"]},"sourceCharacterId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceAssetIds":{"type":"array","items":{"type":"string"}},"storyFacts":{"type":"array","items":{"type":"string"}},"voiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"voiceStyle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","canonicalDescription","anchorPrompt"],"additionalProperties":false}},"scenes":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"title":{"type":"string"},"narration":{"type":"string"},"originalCue":{"anyOf":[{"type":"string"},{"type":"null"}]},"characterIds":{"type":"array","items":{"type":"string"}},"locationId":{"anyOf":[{"type":"string"},{"type":"null"}]},"imagePrompt":{"type":"string"},"motionPrompt":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"factualValidation":{"type":"object","properties":{"status":{"type":"string","enum":["supported","needs_review"]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","note"],"additionalProperties":false}},"required":["index","title","narration","originalCue","characterIds","imagePrompt","motionPrompt","startSeconds","endSeconds","durationSeconds","factualValidation"],"additionalProperties":false}},"costEstimate":{"type":"object","properties":{"unit":{"type":"string","const":"credits"},"planning":{"type":"number"},"styleAnchor":{"type":"number"},"characterAnchors":{"type":"number"},"keyframes":{"type":"number"},"animation":{"type":"number"},"semanticActionQa":{"type":"number"},"total":{"type":"number"}},"required":["unit","planning","characterAnchors","keyframes","animation","total"],"additionalProperties":false}},"required":["version","productionProfile","visualMode","plannerModelId","imageModelId","videoModelId","aspectRatio","voiceId","includeCaptions","captionStyleId","generateBackgroundMusic","generateSoundEffects","script","characters","scenes","costEstimate"],"additionalProperties":false},"preproduction_assets":{"anyOf":[{"type":"object","properties":{"collectionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"styleAnchorAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"characterAnchors":{"type":"array","items":{"type":"object","properties":{"characterId":{"type":"string"},"assetId":{"type":"string"}},"required":["characterId","assetId"],"additionalProperties":false}},"keyframes":{"type":"array","items":{"type":"object","properties":{"sceneIndex":{"type":"number"},"assetId":{"type":"string"},"referenceAssetIds":{"type":"array","items":{"type":"string"}}},"required":["sceneIndex","assetId","referenceAssetIds"],"additionalProperties":false}},"semanticActionQa":{"type":"object","properties":{"version":{"type":"string","const":"semantic-action-v1"},"status":{"type":"string","enum":["passed","failed","unavailable"]},"evaluatedAt":{"type":"string"},"scenes":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"sceneIndex":{"type":"number"},"version":{"type":"string","const":"semantic-action-v1"},"status":{"type":"string","enum":["passed","failed","unavailable"]},"plannedAction":{"type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"type":"string"},"detectedSubjectAction":{"anyOf":[{"type":"string"},{"type":"null"}]},"frames":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","enum":["early","middle","late"]},"timeSeconds":{"type":"number"}},"required":["position","timeSeconds"],"additionalProperties":false}},"firstAnalysis":{"anyOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["pass","fail"]},"earlyState":{"type":"string"},"middleState":{"type":"string"},"lateState":{"type":"string"},"detectedSubjectAction":{"type":"string"},"actionProgressionObserved":{"type":"boolean"},"cameraMotionOnly":{"type":"boolean"},"summary":{"type":"string"},"confidence":{"type":"number"}},"required":["verdict","earlyState","middleState","lateState","detectedSubjectAction","actionProgressionObserved","cameraMotionOnly","summary","confidence"],"additionalProperties":false},{"type":"null"}]},"confirmationAnalysis":{"anyOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["pass","fail"]},"earlyState":{"type":"string"},"middleState":{"type":"string"},"lateState":{"type":"string"},"detectedSubjectAction":{"type":"string"},"actionProgressionObserved":{"type":"boolean"},"cameraMotionOnly":{"type":"boolean"},"summary":{"type":"string"},"confidence":{"type":"number"}},"required":["verdict","earlyState","middleState","lateState","detectedSubjectAction","actionProgressionObserved","cameraMotionOnly","summary","confidence"],"additionalProperties":false},{"type":"null"}]}},"required":["assetId","sceneIndex","version","status","plannedAction","confidence","summary","detectedSubjectAction","frames","firstAnalysis","confirmationAnalysis"],"additionalProperties":false}}},"required":["version","status","evaluatedAt","scenes"],"additionalProperties":false}},"required":["collectionId","characterAnchors","keyframes"],"additionalProperties":false},{"type":"null"}]},"review_options":{"type":"object","properties":{"style_anchor":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependent_scene_indexes":{"type":"array","items":{"type":"number"}},"estimated_regeneration_credits":{"type":"number"}},"required":["label","current_asset_id","dependent_scene_indexes","estimated_regeneration_credits"],"additionalProperties":false},{"type":"null"}]},"scenes":{"type":"array","items":{"type":"object","properties":{"scene_index":{"type":"number"},"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_regeneration_credits":{"type":"number"}},"required":["scene_index","label","current_asset_id","estimated_regeneration_credits"],"additionalProperties":false}},"characters":{"type":"array","items":{"type":"object","properties":{"character_id":{"type":"string"},"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependent_scene_indexes":{"type":"array","items":{"type":"number"}},"estimated_regeneration_credits":{"type":"number"}},"required":["character_id","label","current_asset_id","dependent_scene_indexes","estimated_regeneration_credits"],"additionalProperties":false}}},"required":["style_anchor","scenes","characters"],"additionalProperties":false},"preproduction_job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"generation_job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"plan_approved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"assets_approved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","revision","status","plan","preproduction_assets","review_options","preproduction_job_id","generation_job_id","error","plan_approved_at","assets_approved_at","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/faceless/plans/{revisionId}":{"get":{"operationId":"getProjectsProjectIdFacelessPlansRevisionId","summary":"Get faceless production plan revision","description":"Get faceless production plan revision.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"path","name":"revisionId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"project_id":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["draft","plan_approved","preproduction_processing","awaiting_asset_approval","asset_approved","generating","complete","failed"]},"plan":{"type":"object","properties":{"version":{"type":"string","const":"faceless-production-plan-v1"},"productionProfile":{"type":"string","const":"dramatic_vertical_v1"},"visualMode":{"type":"string","const":"generated_only"},"plannerModelId":{"type":"string"},"imageModelId":{"type":"string"},"videoModelId":{"type":"string"},"aspectRatio":{"type":"string","const":"9:16"},"voiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"includeCaptions":{"type":"boolean"},"captionStyleId":{"anyOf":[{"type":"string"},{"type":"null"}]},"generateBackgroundMusic":{"type":"boolean"},"generateSoundEffects":{"type":"boolean"},"script":{"type":"string"},"storyKitSnapshot":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"story-kit-snapshot-v1"},"storyKitId":{"type":"string"},"revision":{"type":"number"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visualStyle":{"type":"string"},"styleReferenceAssetIds":{"type":"array","items":{"type":"string"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"canonicalDescription":{"type":"string"},"referenceAssetIds":{"type":"array","items":{"type":"string"}},"facts":{"type":"array","items":{"type":"string"}}},"required":["id","name","canonicalDescription","referenceAssetIds","facts"],"additionalProperties":false}},"narratorCharacterId":{"anyOf":[{"type":"string"},{"type":"null"}]},"characters":{"type":"array","items":{"type":"object","properties":{"characterId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonicalDescription":{"type":"string"},"storyFacts":{"type":"array","items":{"type":"string"}},"defaultVoiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultVoiceStyle":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryReferenceAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceAssetIds":{"type":"array","items":{"type":"string"}}},"required":["characterId","name","type","species","canonicalDescription","storyFacts","defaultVoiceId","defaultVoiceStyle","primaryReferenceAssetId","referenceAssetIds"],"additionalProperties":false}}},"required":["version","storyKitId","revision","name","description","visualStyle","styleReferenceAssetIds","facts","locations","narratorCharacterId","characters"],"additionalProperties":false},{"type":"null"}]},"styleAnchorPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"characters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"canonicalDescription":{"type":"string"},"anchorPrompt":{"type":"string"},"source":{"type":"string","enum":["generated","workspace"]},"sourceCharacterId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceAssetIds":{"type":"array","items":{"type":"string"}},"storyFacts":{"type":"array","items":{"type":"string"}},"voiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"voiceStyle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","canonicalDescription","anchorPrompt"],"additionalProperties":false}},"scenes":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"title":{"type":"string"},"narration":{"type":"string"},"originalCue":{"anyOf":[{"type":"string"},{"type":"null"}]},"characterIds":{"type":"array","items":{"type":"string"}},"locationId":{"anyOf":[{"type":"string"},{"type":"null"}]},"imagePrompt":{"type":"string"},"motionPrompt":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"factualValidation":{"type":"object","properties":{"status":{"type":"string","enum":["supported","needs_review"]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","note"],"additionalProperties":false}},"required":["index","title","narration","originalCue","characterIds","imagePrompt","motionPrompt","startSeconds","endSeconds","durationSeconds","factualValidation"],"additionalProperties":false}},"costEstimate":{"type":"object","properties":{"unit":{"type":"string","const":"credits"},"planning":{"type":"number"},"styleAnchor":{"type":"number"},"characterAnchors":{"type":"number"},"keyframes":{"type":"number"},"animation":{"type":"number"},"semanticActionQa":{"type":"number"},"total":{"type":"number"}},"required":["unit","planning","characterAnchors","keyframes","animation","total"],"additionalProperties":false}},"required":["version","productionProfile","visualMode","plannerModelId","imageModelId","videoModelId","aspectRatio","voiceId","includeCaptions","captionStyleId","generateBackgroundMusic","generateSoundEffects","script","characters","scenes","costEstimate"],"additionalProperties":false},"preproduction_assets":{"anyOf":[{"type":"object","properties":{"collectionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"styleAnchorAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"characterAnchors":{"type":"array","items":{"type":"object","properties":{"characterId":{"type":"string"},"assetId":{"type":"string"}},"required":["characterId","assetId"],"additionalProperties":false}},"keyframes":{"type":"array","items":{"type":"object","properties":{"sceneIndex":{"type":"number"},"assetId":{"type":"string"},"referenceAssetIds":{"type":"array","items":{"type":"string"}}},"required":["sceneIndex","assetId","referenceAssetIds"],"additionalProperties":false}},"semanticActionQa":{"type":"object","properties":{"version":{"type":"string","const":"semantic-action-v1"},"status":{"type":"string","enum":["passed","failed","unavailable"]},"evaluatedAt":{"type":"string"},"scenes":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"sceneIndex":{"type":"number"},"version":{"type":"string","const":"semantic-action-v1"},"status":{"type":"string","enum":["passed","failed","unavailable"]},"plannedAction":{"type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"type":"string"},"detectedSubjectAction":{"anyOf":[{"type":"string"},{"type":"null"}]},"frames":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","enum":["early","middle","late"]},"timeSeconds":{"type":"number"}},"required":["position","timeSeconds"],"additionalProperties":false}},"firstAnalysis":{"anyOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["pass","fail"]},"earlyState":{"type":"string"},"middleState":{"type":"string"},"lateState":{"type":"string"},"detectedSubjectAction":{"type":"string"},"actionProgressionObserved":{"type":"boolean"},"cameraMotionOnly":{"type":"boolean"},"summary":{"type":"string"},"confidence":{"type":"number"}},"required":["verdict","earlyState","middleState","lateState","detectedSubjectAction","actionProgressionObserved","cameraMotionOnly","summary","confidence"],"additionalProperties":false},{"type":"null"}]},"confirmationAnalysis":{"anyOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["pass","fail"]},"earlyState":{"type":"string"},"middleState":{"type":"string"},"lateState":{"type":"string"},"detectedSubjectAction":{"type":"string"},"actionProgressionObserved":{"type":"boolean"},"cameraMotionOnly":{"type":"boolean"},"summary":{"type":"string"},"confidence":{"type":"number"}},"required":["verdict","earlyState","middleState","lateState","detectedSubjectAction","actionProgressionObserved","cameraMotionOnly","summary","confidence"],"additionalProperties":false},{"type":"null"}]}},"required":["assetId","sceneIndex","version","status","plannedAction","confidence","summary","detectedSubjectAction","frames","firstAnalysis","confirmationAnalysis"],"additionalProperties":false}}},"required":["version","status","evaluatedAt","scenes"],"additionalProperties":false}},"required":["collectionId","characterAnchors","keyframes"],"additionalProperties":false},{"type":"null"}]},"review_options":{"type":"object","properties":{"style_anchor":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependent_scene_indexes":{"type":"array","items":{"type":"number"}},"estimated_regeneration_credits":{"type":"number"}},"required":["label","current_asset_id","dependent_scene_indexes","estimated_regeneration_credits"],"additionalProperties":false},{"type":"null"}]},"scenes":{"type":"array","items":{"type":"object","properties":{"scene_index":{"type":"number"},"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_regeneration_credits":{"type":"number"}},"required":["scene_index","label","current_asset_id","estimated_regeneration_credits"],"additionalProperties":false}},"characters":{"type":"array","items":{"type":"object","properties":{"character_id":{"type":"string"},"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependent_scene_indexes":{"type":"array","items":{"type":"number"}},"estimated_regeneration_credits":{"type":"number"}},"required":["character_id","label","current_asset_id","dependent_scene_indexes","estimated_regeneration_credits"],"additionalProperties":false}}},"required":["style_anchor","scenes","characters"],"additionalProperties":false},"preproduction_job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"generation_job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"plan_approved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"assets_approved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","revision","status","plan","preproduction_assets","review_options","preproduction_job_id","generation_job_id","error","plan_approved_at","assets_approved_at","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/faceless/plans/{revisionId}/revise":{"post":{"operationId":"createProjectsProjectIdFacelessPlansRevisionIdRevise","summary":"Create a revised faceless production plan","description":"Requires an active paid plan. Copies one immutable revision into a new draft with explicit scene, character, or model changes. It does not call a planning model or generate media.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"path","name":"revisionId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scene_updates":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"scene_index":{"type":"integer","minimum":0,"maximum":11},"title":{"type":"string","minLength":1,"maxLength":200},"character_ids":{"maxItems":2,"type":"array","items":{"type":"string","minLength":1}},"image_prompt":{"type":"string","minLength":1,"maxLength":5000},"motion_prompt":{"type":"string","minLength":1,"maxLength":5000}},"required":["scene_index"]}},"character_updates":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"character_id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":200},"canonical_description":{"type":"string","minLength":1,"maxLength":3000},"anchor_prompt":{"type":"string","minLength":1,"maxLength":3000}},"required":["character_id"]}},"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.","type":"string","minLength":1,"maxLength":3000},"image_model_id":{"type":"string","minLength":3,"maxLength":200},"video_model":{"type":"string","minLength":3,"maxLength":200}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"project_id":{"type":"string"},"revision":{"type":"number"},"status":{"type":"string","enum":["draft","plan_approved","preproduction_processing","awaiting_asset_approval","asset_approved","generating","complete","failed"]},"plan":{"type":"object","properties":{"version":{"type":"string","const":"faceless-production-plan-v1"},"productionProfile":{"type":"string","const":"dramatic_vertical_v1"},"visualMode":{"type":"string","const":"generated_only"},"plannerModelId":{"type":"string"},"imageModelId":{"type":"string"},"videoModelId":{"type":"string"},"aspectRatio":{"type":"string","const":"9:16"},"voiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"includeCaptions":{"type":"boolean"},"captionStyleId":{"anyOf":[{"type":"string"},{"type":"null"}]},"generateBackgroundMusic":{"type":"boolean"},"generateSoundEffects":{"type":"boolean"},"script":{"type":"string"},"storyKitSnapshot":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","const":"story-kit-snapshot-v1"},"storyKitId":{"type":"string"},"revision":{"type":"number"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visualStyle":{"type":"string"},"styleReferenceAssetIds":{"type":"array","items":{"type":"string"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"canonicalDescription":{"type":"string"},"referenceAssetIds":{"type":"array","items":{"type":"string"}},"facts":{"type":"array","items":{"type":"string"}}},"required":["id","name","canonicalDescription","referenceAssetIds","facts"],"additionalProperties":false}},"narratorCharacterId":{"anyOf":[{"type":"string"},{"type":"null"}]},"characters":{"type":"array","items":{"type":"object","properties":{"characterId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonicalDescription":{"type":"string"},"storyFacts":{"type":"array","items":{"type":"string"}},"defaultVoiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultVoiceStyle":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryReferenceAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceAssetIds":{"type":"array","items":{"type":"string"}}},"required":["characterId","name","type","species","canonicalDescription","storyFacts","defaultVoiceId","defaultVoiceStyle","primaryReferenceAssetId","referenceAssetIds"],"additionalProperties":false}}},"required":["version","storyKitId","revision","name","description","visualStyle","styleReferenceAssetIds","facts","locations","narratorCharacterId","characters"],"additionalProperties":false},{"type":"null"}]},"styleAnchorPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"characters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"canonicalDescription":{"type":"string"},"anchorPrompt":{"type":"string"},"source":{"type":"string","enum":["generated","workspace"]},"sourceCharacterId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceAssetIds":{"type":"array","items":{"type":"string"}},"storyFacts":{"type":"array","items":{"type":"string"}},"voiceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"voiceStyle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","canonicalDescription","anchorPrompt"],"additionalProperties":false}},"scenes":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"title":{"type":"string"},"narration":{"type":"string"},"originalCue":{"anyOf":[{"type":"string"},{"type":"null"}]},"characterIds":{"type":"array","items":{"type":"string"}},"locationId":{"anyOf":[{"type":"string"},{"type":"null"}]},"imagePrompt":{"type":"string"},"motionPrompt":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"factualValidation":{"type":"object","properties":{"status":{"type":"string","enum":["supported","needs_review"]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","note"],"additionalProperties":false}},"required":["index","title","narration","originalCue","characterIds","imagePrompt","motionPrompt","startSeconds","endSeconds","durationSeconds","factualValidation"],"additionalProperties":false}},"costEstimate":{"type":"object","properties":{"unit":{"type":"string","const":"credits"},"planning":{"type":"number"},"styleAnchor":{"type":"number"},"characterAnchors":{"type":"number"},"keyframes":{"type":"number"},"animation":{"type":"number"},"semanticActionQa":{"type":"number"},"total":{"type":"number"}},"required":["unit","planning","characterAnchors","keyframes","animation","total"],"additionalProperties":false}},"required":["version","productionProfile","visualMode","plannerModelId","imageModelId","videoModelId","aspectRatio","voiceId","includeCaptions","captionStyleId","generateBackgroundMusic","generateSoundEffects","script","characters","scenes","costEstimate"],"additionalProperties":false},"preproduction_assets":{"anyOf":[{"type":"object","properties":{"collectionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"styleAnchorAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"characterAnchors":{"type":"array","items":{"type":"object","properties":{"characterId":{"type":"string"},"assetId":{"type":"string"}},"required":["characterId","assetId"],"additionalProperties":false}},"keyframes":{"type":"array","items":{"type":"object","properties":{"sceneIndex":{"type":"number"},"assetId":{"type":"string"},"referenceAssetIds":{"type":"array","items":{"type":"string"}}},"required":["sceneIndex","assetId","referenceAssetIds"],"additionalProperties":false}},"semanticActionQa":{"type":"object","properties":{"version":{"type":"string","const":"semantic-action-v1"},"status":{"type":"string","enum":["passed","failed","unavailable"]},"evaluatedAt":{"type":"string"},"scenes":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"sceneIndex":{"type":"number"},"version":{"type":"string","const":"semantic-action-v1"},"status":{"type":"string","enum":["passed","failed","unavailable"]},"plannedAction":{"type":"string"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"summary":{"type":"string"},"detectedSubjectAction":{"anyOf":[{"type":"string"},{"type":"null"}]},"frames":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","enum":["early","middle","late"]},"timeSeconds":{"type":"number"}},"required":["position","timeSeconds"],"additionalProperties":false}},"firstAnalysis":{"anyOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["pass","fail"]},"earlyState":{"type":"string"},"middleState":{"type":"string"},"lateState":{"type":"string"},"detectedSubjectAction":{"type":"string"},"actionProgressionObserved":{"type":"boolean"},"cameraMotionOnly":{"type":"boolean"},"summary":{"type":"string"},"confidence":{"type":"number"}},"required":["verdict","earlyState","middleState","lateState","detectedSubjectAction","actionProgressionObserved","cameraMotionOnly","summary","confidence"],"additionalProperties":false},{"type":"null"}]},"confirmationAnalysis":{"anyOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["pass","fail"]},"earlyState":{"type":"string"},"middleState":{"type":"string"},"lateState":{"type":"string"},"detectedSubjectAction":{"type":"string"},"actionProgressionObserved":{"type":"boolean"},"cameraMotionOnly":{"type":"boolean"},"summary":{"type":"string"},"confidence":{"type":"number"}},"required":["verdict","earlyState","middleState","lateState","detectedSubjectAction","actionProgressionObserved","cameraMotionOnly","summary","confidence"],"additionalProperties":false},{"type":"null"}]}},"required":["assetId","sceneIndex","version","status","plannedAction","confidence","summary","detectedSubjectAction","frames","firstAnalysis","confirmationAnalysis"],"additionalProperties":false}}},"required":["version","status","evaluatedAt","scenes"],"additionalProperties":false}},"required":["collectionId","characterAnchors","keyframes"],"additionalProperties":false},{"type":"null"}]},"review_options":{"type":"object","properties":{"style_anchor":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependent_scene_indexes":{"type":"array","items":{"type":"number"}},"estimated_regeneration_credits":{"type":"number"}},"required":["label","current_asset_id","dependent_scene_indexes","estimated_regeneration_credits"],"additionalProperties":false},{"type":"null"}]},"scenes":{"type":"array","items":{"type":"object","properties":{"scene_index":{"type":"number"},"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_regeneration_credits":{"type":"number"}},"required":["scene_index","label","current_asset_id","estimated_regeneration_credits"],"additionalProperties":false}},"characters":{"type":"array","items":{"type":"object","properties":{"character_id":{"type":"string"},"label":{"type":"string"},"current_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependent_scene_indexes":{"type":"array","items":{"type":"number"}},"estimated_regeneration_credits":{"type":"number"}},"required":["character_id","label","current_asset_id","dependent_scene_indexes","estimated_regeneration_credits"],"additionalProperties":false}}},"required":["style_anchor","scenes","characters"],"additionalProperties":false},"preproduction_job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"generation_job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"plan_approved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"assets_approved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","revision","status","plan","preproduction_assets","review_options","preproduction_job_id","generation_job_id","error","plan_approved_at","assets_approved_at","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/faceless/plans/{revisionId}/approve":{"post":{"operationId":"createProjectsProjectIdFacelessPlansRevisionIdApprove","summary":"Approve faceless plan and generate preproduction assets","description":"Requires an active paid plan. Approves one immutable revision and starts generation of the shared style anchor, synthetic character anchors, and scene keyframes. It does not animate video clips.\n\nCost note: This operation may consume AI credits and can take time to complete.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"path","name":"revisionId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"revision_id":{"type":"string"},"job_id":{"type":"string"},"status":{"type":"string","const":"preproduction_processing"}},"required":["revision_id","job_id","status"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/faceless/plans/{revisionId}/regenerate-assets":{"post":{"operationId":"createProjectsProjectIdFacelessPlansRevisionIdRegenerateAssets","summary":"Regenerate one faceless preproduction asset","description":"Requires an active paid plan. Regenerates one scene keyframe, one character anchor, or the style anchor. Character-anchor and style-anchor regeneration also refresh every dependent scene keyframe.\n\nCost note: This operation may consume AI credits and can take time to complete.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"path","name":"revisionId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_type":{"type":"string","enum":["style_anchor","character_anchor","scene_keyframe"],"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."},"character_id":{"type":"string","minLength":1},"scene_index":{"type":"integer","minimum":0,"maximum":11}},"required":["asset_type"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"revision_id":{"type":"string"},"job_id":{"type":"string"},"status":{"type":"string","const":"preproduction_processing"},"asset_type":{"type":"string","enum":["style_anchor","character_anchor","scene_keyframe"]},"character_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"scene_indexes":{"type":"array","items":{"type":"number"}}},"required":["revision_id","job_id","status","asset_type","character_id","scene_indexes"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/faceless/plans/{revisionId}/approve-assets":{"post":{"operationId":"createProjectsProjectIdFacelessPlansRevisionIdApproveAssets","summary":"Approve keyframes and generate faceless video","description":"Requires an active paid plan. Approves the generated character anchors and keyframes, then starts scene animation and timeline composition from those exact assets.\n\nCost note: This operation may consume AI credits and can take time to complete.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"in":"path","name":"revisionId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"revision_id":{"type":"string"},"job_id":{"type":"string"},"status":{"type":"string","const":"generating"}},"required":["revision_id","job_id","status"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/characters":{"get":{"operationId":"getCharacters","summary":"List workspace characters","description":"Lists reusable workspace characters and their approved reference asset IDs.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"include_archived","schema":{"type":"boolean"}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"returned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"has_more":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["items","total","returned","limit","offset","has_more","truncated"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createCharacters","summary":"Create workspace character","description":"Creates a reusable character from existing workspace image asset IDs.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"type":{"type":"string","enum":["human","fictional","other"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"story_facts":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"default_voice_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"reference_asset_ids":{"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/characters/{characterId}":{"get":{"operationId":"getCharactersCharacterId","summary":"Get workspace character","description":"Get workspace character.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"characterId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateCharactersCharacterId","summary":"Update workspace character","description":"Update workspace character.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"characterId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"type":{"type":"string","enum":["human","fictional","other"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"story_facts":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"default_voice_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"add_reference_asset_ids":{"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"primary_reference_asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/story-kits":{"get":{"operationId":"getStoryKits","summary":"List reusable Story Kits","description":"List reusable Story Kits.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"offset","schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visual_style":{"type":"string"},"style_reference_asset_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","minLength":1,"maxLength":120},"canonical_description":{"type":"string","minLength":1,"maxLength":2000},"reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","name","canonical_description","reference_asset_ids","facts"],"additionalProperties":false}},"character_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"narrator_character_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","revision","name","description","visual_style","style_reference_asset_ids","facts","locations","character_ids","narrator_character_id","created_at","updated_at"],"additionalProperties":false}},"bounds":{"type":"object","properties":{"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"returned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"has_more":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["limit","offset","total","returned","has_more","truncated"],"additionalProperties":false}},"required":["items","bounds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createStoryKits","summary":"Create a reusable Story Kit","description":"Create a reusable Story Kit.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"description":{"default":null,"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"visual_style":{"type":"string","minLength":1,"maxLength":2000},"style_reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"locations":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","minLength":1,"maxLength":120},"canonical_description":{"type":"string","minLength":1,"maxLength":2000},"reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","name","canonical_description"]}},"character_ids":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"narrator_character_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["name","visual_style"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visual_style":{"type":"string"},"style_reference_asset_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","minLength":1,"maxLength":120},"canonical_description":{"type":"string","minLength":1,"maxLength":2000},"reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","name","canonical_description","reference_asset_ids","facts"],"additionalProperties":false}},"character_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"narrator_character_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","revision","name","description","visual_style","style_reference_asset_ids","facts","locations","character_ids","narrator_character_id","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/story-kits/{storyKitId}":{"get":{"operationId":"getStoryKitsStoryKitId","summary":"Inspect a reusable Story Kit","description":"Inspect a reusable Story Kit.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"storyKitId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visual_style":{"type":"string"},"style_reference_asset_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","minLength":1,"maxLength":120},"canonical_description":{"type":"string","minLength":1,"maxLength":2000},"reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","name","canonical_description","reference_asset_ids","facts"],"additionalProperties":false}},"character_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"narrator_character_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","revision","name","description","visual_style","style_reference_asset_ids","facts","locations","character_ids","narrator_character_id","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateStoryKitsStoryKitId","summary":"Update a Story Kit using optimistic concurrency","description":"Update a Story Kit using optimistic concurrency.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"storyKitId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"description":{"default":null,"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"visual_style":{"type":"string","minLength":1,"maxLength":2000},"style_reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"locations":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","minLength":1,"maxLength":120},"canonical_description":{"type":"string","minLength":1,"maxLength":2000},"reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","name","canonical_description"]}},"character_ids":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"narrator_character_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"expected_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["name","visual_style","expected_revision"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"visual_style":{"type":"string"},"style_reference_asset_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","minLength":1,"maxLength":120},"canonical_description":{"type":"string","minLength":1,"maxLength":2000},"reference_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"facts":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","name","canonical_description","reference_asset_ids","facts"],"additionalProperties":false}},"character_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"narrator_character_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","revision","name","description","visual_style","style_reference_asset_ids","facts","locations","character_ids","narrator_character_id","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generation-options/{kind}":{"get":{"operationId":"getGenerationOptions","summary":"List options for one generation outcome","description":"List options for one generation outcome.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"kind","schema":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generate-image":{"post":{"operationId":"generateImage","summary":"Generate an image","description":"Generate an image.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":8,"maxLength":5000},"model":{"default":"fal-ai/nano-banana-2","type":"string","enum":["fal-ai/gpt-image-1","fal-ai/gpt-image-1.5","fal-ai/gpt-image-2","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"]},"aspect_ratio":{"default":"1:1","type":"string","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","5:4","4:5","21:9"]},"reference_asset_ids":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"folder_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"enhance_prompt":{"default":false,"type":"boolean"}},"required":["prompt"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","const":"queued"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["job_id","kind","status","status_url","cancel_url","project_id","media_id","estimated_credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generate-video":{"post":{"operationId":"generateVideo","summary":"Generate a video","description":"Generate a video.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":3,"maxLength":5000},"model":{"default":"wan-2.1","type":"string","enum":["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","sora-2","sora-2-pro","veo3","veo3.1","veo3.1-fast","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","sora-2-t2v","sora-2-pro-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-19b-t2v","ltx-2-19b-distilled-t2v"]},"duration_seconds":{"default":5,"anyOf":[{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7},{"type":"number","const":8},{"type":"number","const":9},{"type":"number","const":10},{"type":"number","const":11},{"type":"number","const":12},{"type":"number","const":13},{"type":"number","const":14},{"type":"number","const":15},{"type":"number","const":16},{"type":"number","const":17},{"type":"number","const":18},{"type":"number","const":19},{"type":"number","const":20},{"type":"number","const":21},{"type":"number","const":22},{"type":"number","const":23},{"type":"number","const":24},{"type":"number","const":25},{"type":"number","const":26},{"type":"number","const":27},{"type":"number","const":28},{"type":"number","const":29},{"type":"number","const":30}]},"aspect_ratio":{"default":"9:16","type":"string","enum":["9:16","16:9","1:1"]},"source_asset_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"reference_asset_ids":{"default":[],"maxItems":29,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reference_video_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reference_audio_asset_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"resolution":{"default":null,"anyOf":[{"type":"string","enum":["480p","720p"]},{"type":"null"}]},"generate_audio":{"default":true,"type":"boolean"},"negative_prompt":{"default":null,"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}]},"seed":{"default":null,"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"folder_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"provider":{"default":"auto","type":"string","enum":["auto","byteplus-modelark","fal"]},"enhance_prompt":{"default":false,"type":"boolean"}},"required":["prompt"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","const":"queued"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["job_id","kind","status","status_url","cancel_url","project_id","media_id","estimated_credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generate-voiceover":{"post":{"operationId":"generateVoiceover","summary":"Generate a voiceover","description":"Generate a voiceover.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":3,"maxLength":8000},"voice_id":{"default":"pNInz6obpgDQGcFmaJgB","type":"string","minLength":1,"maxLength":200},"voice_style":{"default":"neutral","type":"string","enum":["curiosity","intrigue","urgency","tension","concern","surprise","hope","satisfaction","inspiration","revelation","neutral"]},"speed":{"default":1,"type":"number","minimum":0.5,"maximum":1.6}},"required":["text"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","const":"queued"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["job_id","kind","status","status_url","cancel_url","project_id","media_id","estimated_credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generate-music":{"post":{"operationId":"generateMusic","summary":"Generate music","description":"Generate music.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"default":"","type":"string","maxLength":500},"mood":{"default":"neutral","type":"string","enum":["curiosity","intrigue","urgency","tension","concern","surprise","hope","satisfaction","inspiration","revelation","neutral"]},"duration_seconds":{"default":30,"type":"number","minimum":10,"maximum":120},"enhance_prompt":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","const":"queued"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["job_id","kind","status","status_url","cancel_url","project_id","media_id","estimated_credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generate-sound":{"post":{"operationId":"generateSound","summary":"Generate a sound","description":"Generate a sound.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":3,"maxLength":500},"duration_seconds":{"default":2,"type":"number","minimum":0.5,"maximum":30},"loop":{"default":false,"type":"boolean"},"prompt_influence":{"default":0.5,"type":"number","minimum":0,"maximum":1},"enhance_prompt":{"default":false,"type":"boolean"}},"required":["prompt"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","const":"queued"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["job_id","kind","status","status_url","cancel_url","project_id","media_id","estimated_credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generate-faceless":{"post":{"operationId":"generateFaceless","summary":"Create a Faceless Video plan","description":"Create a Faceless Video plan.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"script":{"type":"string","minLength":1,"maxLength":30000},"project_name":{"default":"Faceless Video","type":"string","minLength":1,"maxLength":200},"target_duration_seconds":{"default":45,"type":"number","minimum":10,"maximum":120},"visual_style":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":2000},{"type":"null"}]},"story_kit_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"planner_model_id":{"default":"anthropic/claude-opus-4-6","type":"string","minLength":3,"maxLength":200},"image_model_id":{"default":"fal-ai/nano-banana-pro","type":"string","minLength":3,"maxLength":200},"video_model":{"default":"seedance-2.0-ref2v","type":"string","enum":["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","sora-2","sora-2-pro","veo3","veo3.1","veo3.1-fast","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","sora-2-t2v","sora-2-pro-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-19b-t2v","ltx-2-19b-distilled-t2v"]},"generate_voiceover":{"default":true,"type":"boolean"},"voice_id":{"default":null,"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"include_captions":{"default":true,"type":"boolean"},"caption_style_id":{"default":null,"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"generate_background_music":{"default":false,"type":"boolean"},"generate_sound_effects":{"default":false,"type":"boolean"},"character_ids":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["script"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","const":"queued"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["job_id","kind","status","status_url","cancel_url","project_id","media_id","estimated_credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generation-jobs/{jobId}":{"get":{"operationId":"getGenerationJob","summary":"Get a generation job","description":"Get a generation job.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"jobId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","enum":["queued","processing","complete","failed","canceled"]},"progress":{"type":"number"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["job_id","kind","status","progress","status_url","cancel_url","project_id","media_id","download_url","estimated_credits","result","error","created_at","completed_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/generation-jobs/{jobId}/cancel":{"post":{"operationId":"cancelGenerationJob","summary":"Cancel a generation job","description":"Cancel a generation job.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"jobId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["image","video","voiceover","music","sound","faceless"]},"status":{"type":"string","enum":["queued","processing","complete","failed","canceled"]},"progress":{"type":"number"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["job_id","kind","status","progress","status_url","cancel_url","project_id","media_id","download_url","estimated_credits","result","error","created_at","completed_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/export":{"post":{"operationId":"startProjectExport","summary":"Export project","description":"Export a video or carousel project. For video projects, returns MP4/MOV video files or thin FCPXML timeline metadata with container_format='mp4'/'mov'/'fcpxml'. FCPXML exports do not bundle media and may reference signed cloud URLs that expire, so relinking may be required. For carousel projects, returns ZIP archive with individual slides as JPG/PNG images. Response includes container_format and image_formats fields.\n\nCost note: This operation may consume AI credits and can take time to complete.","tags":["Exports and Jobs"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"resolution":{"description":"Video resolution: '720p', '1080p', or '4k'. Ignored for carousel projects.","type":"string"},"format":{"description":"Output format: 'mp4', 'mov', 'fcpxml' for videos; 'zip', 'png', 'jpeg' for carousels. FCPXML is metadata-only and does not bundle media. Defaults to 'mp4' for videos, 'jpeg' for carousels.","type":"string"},"cover_frame_seconds":{"description":"Optional video thumbnail frame timestamp in timeline seconds. Omit or pass null to use smart automatic selection.","anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["expected_revision"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"job_id":{"type":"string"},"status":{"type":"string"},"revision":{"type":"number"}},"required":["export_id","job_id","status","revision"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/exports/{exportId}":{"get":{"operationId":"getExport","summary":"Get export status","description":"Get export status.","tags":["Exports and Jobs"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"exportId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"export_id":{"type":"string"},"status":{"type":"string"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame":{"anyOf":[{"type":"number"},{"type":"null"}]},"frame_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"selection_mode":{"anyOf":[{"type":"string"},{"type":"null"}]},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url","frame","frame_seconds","selection_mode","rationale"],"additionalProperties":false},{"type":"null"}]},"platform_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_size_bytes":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"container_format":{"anyOf":[{"type":"string"},{"type":"null"}]},"image_formats":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["export_id","status","download_url","short_download_url","thumbnail_url","thumbnail","platform_metadata","expires_at","file_size_bytes","duration_seconds","container_format","image_formats"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/jobs/{jobId}":{"get":{"operationId":"getJob","summary":"Get job status","description":"Get job status.","tags":["Exports and Jobs"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"jobId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"type":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","processing","complete","failed","canceled"]},"progress":{"type":"number"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}},"result":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["job_id","type","status","progress","project_id","created_at","completed_at","error"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/jobs":{"get":{"operationId":"listProjectJobs","summary":"List jobs for project","description":"List jobs for project.","tags":["Exports and Jobs"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string"},"type":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","processing","complete","failed","canceled"]},"progress":{"type":"number"},"status_url":{"type":"string","format":"uri"},"cancel_url":{"type":"string","format":"uri"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"media_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"estimated_credits":{"anyOf":[{"type":"number"},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}},"result":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["job_id","type","status","progress","project_id","created_at","completed_at","error"],"additionalProperties":false}}},"required":["jobs"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/exports":{"get":{"operationId":"listProjectExports","summary":"List project exports","description":"List project exports.","tags":["Exports and Jobs"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":50}},{"in":"query","name":"offset","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"exports":{"type":"array","items":{"type":"object","properties":{"export_id":{"type":"string"},"status":{"type":"string"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"short_download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame":{"anyOf":[{"type":"number"},{"type":"null"}]},"frame_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"selection_mode":{"anyOf":[{"type":"string"},{"type":"null"}]},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url","frame","frame_seconds","selection_mode","rationale"],"additionalProperties":false},{"type":"null"}]},"platform_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_size_bytes":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"container_format":{"anyOf":[{"type":"string"},{"type":"null"}]},"image_formats":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["export_id","status","download_url","short_download_url","thumbnail_url","thumbnail","platform_metadata","expires_at","file_size_bytes","duration_seconds","container_format","image_formats"],"additionalProperties":false}},"count":{"type":"number"}},"required":["exports","count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/context":{"get":{"operationId":"getProjectContext","summary":"Get project context","description":"Get project context.","tags":["Project Context"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"mode","schema":{"type":"string","enum":["summary","assets","timeline","transcript","full"]}},{"in":"query","name":"search","schema":{"type":"string"}},{"in":"query","name":"asset_limit","schema":{"type":"number","minimum":1,"maximum":50}},{"in":"query","name":"asset_offset","schema":{"type":"number","minimum":0}},{"in":"query","name":"timeline_limit","schema":{"type":"number","minimum":1,"maximum":1000}},{"in":"query","name":"timeline_offset","schema":{"type":"number","minimum":0}},{"in":"query","name":"transcript_limit","schema":{"type":"number","minimum":1,"maximum":500}},{"in":"query","name":"transcript_offset","schema":{"type":"number","minimum":0}},{"in":"query","name":"caption_word_limit","schema":{"type":"number","minimum":1,"maximum":2000}},{"in":"query","name":"caption_word_offset","schema":{"type":"number","minimum":0}},{"in":"query","name":"media_asset_types","schema":{"type":"array","items":{"type":"string","enum":["all","image","video","audio"]}}},{"in":"query","name":"folder_ids","schema":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},{"in":"query","name":"include_subfolders","schema":{"type":"boolean"}},{"in":"query","name":"include_transcripts","schema":{"type":"boolean"}},{"in":"query","name":"include_caption_words","schema":{"type":"boolean"}},{"in":"query","name":"include_timeline_items","schema":{"type":"boolean"}},{"in":"query","name":"include_media_assets","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"summary"},"data":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspectRatio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]},"fps":{"type":"number"},"unitsPerFrame":{"type":"number"},"compositionWidth":{"type":"number"},"compositionHeight":{"type":"number"},"durationSeconds":{"type":"number"}},"required":["id","title","description","aspectRatio","fps","unitsPerFrame","compositionWidth","compositionHeight","durationSeconds"],"additionalProperties":false},"assetCounts":{"type":"object","properties":{"video":{"type":"number"},"audio":{"type":"number"},"image":{"type":"number"}},"required":["video","audio","image"],"additionalProperties":false},"timelineItemCounts":{"type":"object","properties":{"video":{"type":"number"},"audio":{"type":"number"},"caption":{"type":"number"},"image":{"type":"number"},"fillLayer":{"type":"number"},"effect":{"type":"number"},"other":{"type":"number"}},"required":["video","audio","caption","image","fillLayer","effect","other"],"additionalProperties":false},"templateSettings":{"type":"object","properties":{"isTemplate":{"type":"boolean"},"variableCount":{"type":"number"},"bindingCount":{"type":"number"}},"required":["isTemplate","variableCount","bindingCount"],"additionalProperties":false},"captionStyle":{"type":"object","properties":{"source":{"type":"string","enum":["organization_default","user_default","built_in_default"]},"captionThemeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"captionThemeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"wordOverrideCount":{"type":"number"}},"required":["source","captionThemeId","captionThemeName","wordOverrideCount"],"additionalProperties":false},"userPreferences":{"anyOf":[{"type":"object","properties":{"creatorIdentity":{"anyOf":[{"type":"string","enum":["educator","storyteller","entertainer","expert","brand","explorer"]},{"type":"null"}]},"contentVibe":{"anyOf":[{"type":"string","enum":["calm","conversational","high-energy","professional"]},{"type":"null"}]},"aiWritingStyle":{"anyOf":[{"type":"string","enum":["conversational","storyteller","educator","hype","documentary"]},{"type":"null"}]},"aiControversy":{"anyOf":[{"type":"string","enum":["safe","mild","edgy"]},{"type":"null"}]},"workspaceDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeWords":{"type":"array","items":{"type":"string"}}},"required":["creatorIdentity","contentVibe","aiWritingStyle","aiControversy","workspaceDescription","safeWords"],"additionalProperties":false},{"type":"null"}]}},"required":["project","assetCounts","timelineItemCounts","templateSettings","captionStyle","userPreferences"],"additionalProperties":false},"bounds":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"returned":{"type":"number"},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["name","offset","limit","total","returned","hasMore","truncated"],"additionalProperties":false}}},"required":["collections"],"additionalProperties":false}},"required":["mode","data","bounds"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"assets"},"data":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"assetType":{"type":"string","enum":["image","video","audio"]},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"aiPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["assetId","assetType","name","description","folderId","folderName","folderPath","tags","aiPrompt"],"additionalProperties":false}},"total":{"type":"number"},"hasMore":{"type":"boolean"},"offset":{"type":"number"},"limit":{"type":"number"}},"required":["assets","total","hasMore","offset","limit"],"additionalProperties":false},"bounds":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"returned":{"type":"number"},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["name","offset","limit","total","returned","hasMore","truncated"],"additionalProperties":false}}},"required":["collections"],"additionalProperties":false}},"required":["mode","data","bounds"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"timeline"},"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timelineItemId":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]},"mediaAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentItemId":{"anyOf":[{"type":"string"},{"type":"null"}]},"captionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"layerIndex":{"type":"number"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","timelineItemId","type","label","mediaAssetId","contentItemId","captionId","startSeconds","endSeconds","layerIndex","volume"],"additionalProperties":false}},"totalItems":{"type":"number"},"durationSeconds":{"type":"number"}},"required":["items","totalItems","durationSeconds"],"additionalProperties":false},"bounds":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"returned":{"type":"number"},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["name","offset","limit","total","returned","hasMore","truncated"],"additionalProperties":false}}},"required":["collections"],"additionalProperties":false}},"required":["mode","data","bounds"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"transcript"},"data":{"type":"object","properties":{"segments":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"}},"required":["text","startSeconds","endSeconds"],"additionalProperties":false}},"totalWords":{"type":"number"},"durationSeconds":{"type":"number"}},"required":["segments","totalWords","durationSeconds"],"additionalProperties":false},"bounds":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"returned":{"type":"number"},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["name","offset","limit","total","returned","hasMore","truncated"],"additionalProperties":false}}},"required":["collections"],"additionalProperties":false}},"required":["mode","data","bounds"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"full"},"data":{"type":"object","properties":{"captionWords":{"type":"array","items":{"type":"object","properties":{"captionId":{"type":"string"},"wordId":{"type":"string"},"word":{"type":"string"},"sequenceIndex":{"type":"number"},"orderIndex":{"type":"number"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"}},"required":["captionId","wordId","word","sequenceIndex","orderIndex","startSeconds","endSeconds"],"additionalProperties":false}},"captionWordsTable":{"type":"string"},"transcriptSegments":{"anyOf":[{"type":"object","properties":{"segments":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"}},"required":["text","startSeconds","endSeconds"],"additionalProperties":false}},"totalWords":{"type":"number"},"durationSeconds":{"type":"number"}},"required":["segments","totalWords","durationSeconds"],"additionalProperties":false},{"type":"null"}]},"timelineRanges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"label":{"type":"string"}},"required":["id","type","startSeconds","endSeconds","label"],"additionalProperties":false}},"timelineItems":{"type":"array","items":{"type":"object","properties":{"timelineItemId":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"layerIndex":{"type":"number"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"mediaAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentItemId":{"anyOf":[{"type":"string"},{"type":"null"}]},"captionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"positionMode":{"type":"string","enum":["pixels","normalized","preset","none"]},"positionX":{"anyOf":[{"type":"number"},{"type":"null"}]},"positionY":{"anyOf":[{"type":"number"},{"type":"null"}]},"widthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"heightPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"keepAspectRatio":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"sourceWidth":{"anyOf":[{"type":"number"},{"type":"null"}]},"sourceHeight":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["timelineItemId","type","label","startSeconds","endSeconds","layerIndex","volume","mediaAssetId","contentItemId","captionId","positionMode","positionX","positionY","widthPx","heightPx","keepAspectRatio","sourceWidth","sourceHeight"],"additionalProperties":false}},"projectSettings":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]},"fps":{"type":"number"},"unitsPerFrame":{"type":"number"},"compositionWidth":{"type":"number"},"compositionHeight":{"type":"number"}},"required":["aspectRatio","fps","unitsPerFrame","compositionWidth","compositionHeight"],"additionalProperties":false},"templateSettings":{"type":"object","properties":{"isTemplate":{"type":"boolean"},"templateType":{"anyOf":[{"type":"string","enum":["intro","outro","full","overlay"]},{"type":"null"}]},"templateVisibility":{"type":"string","enum":["private","shared","public"]},"variables":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["text","image","color"]},"defaultValue":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["key","name","type","defaultValue"],"additionalProperties":false}},"bindings":{"type":"array","items":{"type":"object","properties":{"variableKey":{"type":"string"},"timelineItemId":{"type":"string"},"property":{"type":"string"}},"required":["variableKey","timelineItemId","property"],"additionalProperties":false}}},"required":["isTemplate","templateType","templateVisibility","variables","bindings"],"additionalProperties":false},"mediaAssets":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"assetType":{"type":"string","enum":["image","video","audio"]},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"aiPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["assetId","assetType","name","description","folderId","folderName","folderPath","tags","aiPrompt"],"additionalProperties":false}},"brollAssets":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"assetType":{"type":"string","enum":["image","video","audio"]},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"aiPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["assetId","assetType","name","description","folderId","folderName","folderPath","tags","aiPrompt"],"additionalProperties":false}},"userPreferences":{"anyOf":[{"type":"object","properties":{"creatorIdentity":{"anyOf":[{"type":"string","enum":["educator","storyteller","entertainer","expert","brand","explorer"]},{"type":"null"}]},"contentVibe":{"anyOf":[{"type":"string","enum":["calm","conversational","high-energy","professional"]},{"type":"null"}]},"aiWritingStyle":{"anyOf":[{"type":"string","enum":["conversational","storyteller","educator","hype","documentary"]},{"type":"null"}]},"aiControversy":{"anyOf":[{"type":"string","enum":["safe","mild","edgy"]},{"type":"null"}]},"workspaceDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeWords":{"type":"array","items":{"type":"string"}}},"required":["creatorIdentity","contentVibe","aiWritingStyle","aiControversy","workspaceDescription","safeWords"],"additionalProperties":false},{"type":"null"}]}},"required":["captionWords","captionWordsTable","transcriptSegments","timelineRanges","timelineItems","projectSettings","templateSettings","mediaAssets","brollAssets","userPreferences"],"additionalProperties":false},"bounds":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"returned":{"type":"number"},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["name","offset","limit","total","returned","hasMore","truncated"],"additionalProperties":false}}},"required":["collections"],"additionalProperties":false}},"required":["mode","data","bounds"],"additionalProperties":false}]}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/fonts":{"get":{"operationId":"getFonts","summary":"List supported font families","description":"List supported font families.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"surface","schema":{"type":"string","enum":["captions","playground"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"fonts":{"type":"array","items":{"type":"object","properties":{"family":{"type":"string"},"supported_weights":{"type":"array","items":{"type":"string"}},"surfaces":{"type":"array","items":{"type":"string","enum":["captions","playground"]}}},"required":["family","supported_weights","surfaces"],"additionalProperties":false}}},"required":["fonts"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/at":{"get":{"operationId":"getTimelineAtTime","summary":"Get timeline items at time","description":"Get timeline items at time.","tags":["Project Context"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"time_seconds","schema":{"type":"number","minimum":0},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"timeSeconds":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"layerIndex":{"type":"number"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"mediaAssetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentItemId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","type","label","layerIndex","volume","startSeconds","endSeconds","mediaAssetId","contentItemId"],"additionalProperties":false}}},"required":["timeSeconds","items"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/edits":{"post":{"operationId":"createProjectsProjectIdTimelineEdits","summary":"Edit timeline items","description":"Edit timeline items.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional retry key for trim and split actions, including batch trim. Other actions do not consume this header.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"allOf":[{"type":"object","properties":{"action":{"type":"string","enum":["trim","split","delete","move","transform"]},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}},"snap_to_frame":{"type":"boolean"},"split_at_seconds":{"type":"number","minimum":0},"timeline_item_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"auto_pack":{"type":"boolean"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["action"]},{"type":"object","properties":{"action":{"type":"string","enum":["trim"]}},"required":["action"],"anyOf":[{"required":["timeline_item_id"]},{"required":["items"]}]}]},{"allOf":[{"type":"object","properties":{"action":{"type":"string","enum":["trim","split","delete","move","transform"]},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}},"snap_to_frame":{"type":"boolean"},"split_at_seconds":{"type":"number","minimum":0},"timeline_item_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"auto_pack":{"type":"boolean"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["action"]},{"type":"object","properties":{"action":{"type":"string","enum":["split"]}},"required":["action","timeline_item_id","split_at_seconds"]}]},{"allOf":[{"type":"object","properties":{"action":{"type":"string","enum":["trim","split","delete","move","transform"]},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}},"snap_to_frame":{"type":"boolean"},"split_at_seconds":{"type":"number","minimum":0},"timeline_item_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"auto_pack":{"type":"boolean"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["action"]},{"type":"object","properties":{"action":{"type":"string","enum":["delete"]}},"required":["action","timeline_item_ids"]}]},{"allOf":[{"type":"object","properties":{"action":{"type":"string","enum":["trim","split","delete","move","transform"]},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}},"snap_to_frame":{"type":"boolean"},"split_at_seconds":{"type":"number","minimum":0},"timeline_item_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"auto_pack":{"type":"boolean"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["action"]},{"type":"object","properties":{"action":{"type":"string","enum":["move"]}},"required":["action"],"anyOf":[{"required":["timeline_item_id","new_start_seconds"]},{"required":["items"],"properties":{"items":{"type":"array","minItems":1,"items":{"type":"object","required":["timeline_item_id","new_start_seconds"]}}}}]}]},{"allOf":[{"type":"object","properties":{"action":{"type":"string","enum":["trim","split","delete","move","transform"]},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}},"snap_to_frame":{"type":"boolean"},"split_at_seconds":{"type":"number","minimum":0},"timeline_item_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"auto_pack":{"type":"boolean"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["action"]},{"type":"object","properties":{"action":{"type":"string","enum":["transform"]}},"required":["action"],"anyOf":[{"required":["timeline_item_id"],"anyOf":[{"required":["position_x"]},{"required":["position_y"]},{"required":["width_px"]},{"required":["height_px"]},{"required":["keep_aspect_ratio"]}]},{"required":["items"],"properties":{"items":{"type":"array","minItems":1,"items":{"type":"object","required":["timeline_item_id"],"anyOf":[{"required":["position_x"]},{"required":["position_y"]},{"required":["width_px"]},{"required":["height_px"]},{"required":["keep_aspect_ratio"]}]}}}}]}]}]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"action":{"type":"string","const":"trim"},"result":{"anyOf":[{"type":"object","properties":{"success":{"type":"boolean"},"trimmed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"success":{"type":"boolean"},"trim_start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"trim_end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"new_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["timeline_item_id","success","trim_start_seconds","trim_end_seconds","new_duration_seconds","error"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","trimmed_count","failed_count","items","failed_items"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"trim_start_units":{"type":"number"},"trim_end_units":{"type":"number"},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"new_duration_seconds":{"type":"number"},"message":{"type":"string"}},"required":["success","timeline_item_id","trim_start_units","trim_end_units","trim_start_seconds","trim_end_seconds","new_duration_seconds"],"additionalProperties":false}]}},"required":["action","result"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"split"},"result":{"type":"object","properties":{"success":{"type":"boolean"},"left_id":{"type":"string"},"right_id":{"type":"string"},"split_at_seconds":{"type":"number"},"message":{"type":"string"}},"required":["success","left_id","right_id","split_at_seconds"],"additionalProperties":false}},"required":["action","result"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"delete"},"result":{"anyOf":[{"type":"object","properties":{"success":{"type":"boolean"},"deleted_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"deleted_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","name","type"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"captions_removed":{"type":"integer","minimum":0,"maximum":9007199254740991},"packed":{"type":"boolean"},"clips_shifted":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":"string"}},"required":["success","deleted_count","failed_count","deleted_items","failed_items","captions_removed","packed","clips_shifted"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean"},"deleted_item_id":{"type":"string"},"deleted_item_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_item_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"captions_removed":{"type":"number"},"message":{"type":"string"}},"required":["success","deleted_item_id","deleted_item_name","deleted_item_type","captions_removed"],"additionalProperties":false}]}},"required":["action","result"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"move"},"result":{"anyOf":[{"type":"object","properties":{"success":{"type":"boolean"},"repositioned_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"previous_start_seconds":{"type":"number"},"new_start_seconds":{"type":"number"},"previous_layer_index":{"type":"number"},"new_layer_index":{"type":"number"}},"required":["timeline_item_id","previous_start_seconds","new_start_seconds","previous_layer_index","new_layer_index"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","repositioned_count","failed_count","items","failed_items"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"previous_start_seconds":{"type":"number"},"new_start_seconds":{"type":"number"},"previous_layer_index":{"type":"number"},"new_layer_index":{"type":"number"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["success","timeline_item_id","previous_start_seconds","new_start_seconds","previous_layer_index","new_layer_index"],"additionalProperties":false}]}},"required":["action","result"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"transform"},"result":{"anyOf":[{"type":"object","properties":{"success":{"type":"boolean"},"updated_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"success":{"type":"boolean"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["timeline_item_id","success","error"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","updated_count","failed_count","items","failed_items"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"asset_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous":{"type":"object","properties":{"position_x":{"anyOf":[{"type":"number"},{"type":"null"}]},"position_y":{"anyOf":[{"type":"number"},{"type":"null"}]},"width_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"height_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"keep_aspect_ratio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["position_x","position_y","width_px","height_px","keep_aspect_ratio"],"additionalProperties":false},"updated":{"type":"object","properties":{"position_x":{"anyOf":[{"type":"number"},{"type":"null"}]},"position_y":{"anyOf":[{"type":"number"},{"type":"null"}]},"width_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"height_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"keep_aspect_ratio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["position_x","position_y","width_px","height_px","keep_aspect_ratio"],"additionalProperties":false},"message":{"type":"string"},"error":{"type":"string"}},"required":["success"],"additionalProperties":false}]}},"required":["action","result"],"additionalProperties":false}],"type":"object"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/timeline/trim":{"post":{"operationId":"createProjectsProjectIdTimelineTrim","summary":"Trim timeline item edges","description":"Deprecated compatibility response. Use POST /projects/{projectId}/timeline/operations/execute.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"deprecated":true,"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"snap_to_frame":{"type":"boolean"}},"required":["timeline_item_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"trim_start_units":{"type":"number"},"trim_end_units":{"type":"number"},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"new_duration_seconds":{"type":"number"},"message":{"type":"string"}},"required":["success","timeline_item_id","trim_start_units","trim_end_units","trim_start_seconds","trim_end_seconds","new_duration_seconds"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/timeline/split":{"post":{"operationId":"createProjectsProjectIdTimelineSplit","summary":"Split a timeline item","description":"Deprecated compatibility response. Use POST /projects/{projectId}/timeline/operations/execute.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"deprecated":true,"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"split_at_seconds":{"type":"number","minimum":0},"snap_to_frame":{"type":"boolean"}},"required":["timeline_item_id","split_at_seconds"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"left_id":{"type":"string"},"right_id":{"type":"string"},"split_at_seconds":{"type":"number"},"message":{"type":"string"}},"required":["success","left_id","right_id","split_at_seconds"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/timeline/cut":{"post":{"operationId":"createProjectsProjectIdTimelineCut","summary":"Cut media ranges and ripple linked captions","description":"Cut media ranges and ripple linked captions.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"cuts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0},"trim_following_seconds":{"type":"number","minimum":0}},"required":["start_seconds","end_seconds"]}},"snap_to_frame":{"type":"boolean"},"ripple":{"type":"boolean"}},"required":["timeline_item_id","cuts"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"cuts_applied":{"type":"number"},"created_splits":{"type":"number"},"deleted_segments":{"type":"number"},"deleted_words":{"type":"number"},"trimmed_following":{"type":"number"},"shifted_items":{"type":"number"},"message":{"type":"string"}},"required":["success","timeline_item_id","cuts_applied","created_splits","deleted_segments","deleted_words","trimmed_following","shifted_items"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/move":{"post":{"operationId":"createProjectsProjectIdTimelineMove","summary":"Move a timeline item","description":"Move a timeline item.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["timeline_item_id","new_start_seconds"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"previous_start_seconds":{"type":"number"},"new_start_seconds":{"type":"number"},"previous_layer_index":{"type":"number"},"new_layer_index":{"type":"number"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["success","timeline_item_id","previous_start_seconds","new_start_seconds","previous_layer_index","new_layer_index"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/transform":{"post":{"operationId":"createProjectsProjectIdTimelineTransform","summary":"Update a timeline item transform","description":"Update a timeline item transform.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"asset_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous":{"type":"object","properties":{"position_x":{"anyOf":[{"type":"number"},{"type":"null"}]},"position_y":{"anyOf":[{"type":"number"},{"type":"null"}]},"width_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"height_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"keep_aspect_ratio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["position_x","position_y","width_px","height_px","keep_aspect_ratio"],"additionalProperties":false},"updated":{"type":"object","properties":{"position_x":{"anyOf":[{"type":"number"},{"type":"null"}]},"position_y":{"anyOf":[{"type":"number"},{"type":"null"}]},"width_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"height_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"keep_aspect_ratio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["position_x","position_y","width_px","height_px","keep_aspect_ratio"],"additionalProperties":false},"message":{"type":"string"},"error":{"type":"string"}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/items/{timelineItemId}":{"delete":{"operationId":"deleteProjectsProjectIdTimelineItemsTimelineItemId","summary":"Delete a timeline item","description":"Delete a timeline item.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"deleted_item_id":{"type":"string"},"deleted_item_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_item_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"captions_removed":{"type":"number"},"message":{"type":"string"}},"required":["success","deleted_item_id","deleted_item_name","deleted_item_type","captions_removed"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/batch-trim":{"post":{"operationId":"createProjectsProjectIdTimelineBatchTrim","summary":"Batch trim timeline items","description":"Batch trim timeline items.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"}},"required":["timeline_item_id"]}},"snap_to_frame":{"type":"boolean"}},"required":["items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"trimmed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"success":{"type":"boolean"},"trim_start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"trim_end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"new_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["timeline_item_id","success","trim_start_seconds","trim_end_seconds","new_duration_seconds","error"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","trimmed_count","failed_count","items","failed_items"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/timeline/batch-move":{"post":{"operationId":"createProjectsProjectIdTimelineBatchMove","summary":"Batch move timeline items","description":"Batch move timeline items.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"new_start_seconds":{"type":"number","minimum":0},"new_layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["timeline_item_id","new_start_seconds"]}}},"required":["items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"repositioned_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"previous_start_seconds":{"type":"number"},"new_start_seconds":{"type":"number"},"previous_layer_index":{"type":"number"},"new_layer_index":{"type":"number"}},"required":["timeline_item_id","previous_start_seconds","new_start_seconds","previous_layer_index","new_layer_index"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","repositioned_count","failed_count","items","failed_items"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/batch-transform":{"post":{"operationId":"createProjectsProjectIdTimelineBatchTransform","summary":"Batch update timeline item transforms","description":"Batch update timeline item transforms.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"position_x":{"type":"number","minimum":-10000,"maximum":10000},"position_y":{"type":"number","minimum":-10000,"maximum":10000},"width_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"height_px":{"anyOf":[{"type":"integer","minimum":1,"maximum":10000},{"type":"null"}]},"keep_aspect_ratio":{"type":"boolean"}},"required":["timeline_item_id"]}}},"required":["items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updated_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"success":{"type":"boolean"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["timeline_item_id","success","error"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","updated_count","failed_count","items","failed_items"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/batch-delete":{"post":{"operationId":"createProjectsProjectIdTimelineBatchDelete","summary":"Batch delete timeline items","description":"Batch delete timeline items.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"auto_pack":{"type":"boolean"}},"required":["timeline_item_ids"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"deleted_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"deleted_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","name","type"],"additionalProperties":false}},"failed_items":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"error":{"type":"string"},"error_code":{"type":"string","enum":["validation_error","not_found","permission_denied","revision_conflict","idempotency_conflict","operation_in_progress","operation_previous_failure","sequence_busy","mutation_failed"]},"retryable":{"type":"boolean"},"error_details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["timeline_item_id","error","error_code","retryable","error_details"],"additionalProperties":false}},"captions_removed":{"type":"integer","minimum":0,"maximum":9007199254740991},"packed":{"type":"boolean"},"clips_shifted":{"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":"string"}},"required":["success","deleted_count","failed_count","deleted_items","failed_items","captions_removed","packed","clips_shifted"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/operations/execute":{"post":{"operationId":"executeSequenceTimingOperation","summary":"Execute a sequence timing operation","description":"Execute a sequence timing operation.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"name":"Idempotency-Key","in":"header","required":true,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"oneOf":[{"type":"object","properties":{"operation_id":{"type":"string","const":"timeline.item.trim"},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"snap_to_frame":{"type":"boolean"}},"required":["operation_id","timeline_item_id","trim_start_delta_seconds","trim_end_delta_seconds","snap_to_frame"]},{"type":"object","properties":{"operation_id":{"type":"string","const":"timeline.item.split"},"timeline_item_id":{"type":"string"},"split_at_seconds":{"type":"number","minimum":0},"snap_to_frame":{"type":"boolean"}},"required":["operation_id","timeline_item_id","split_at_seconds","snap_to_frame"]}],"type":"object"},"expected_revision":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["operation","expected_revision"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"mutation_receipt_id":{"type":"string"},"idempotency_key":{"type":"string"},"base_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"replayed":{"type":"boolean"},"txid":{"type":"integer","minimum":0,"maximum":9007199254740991},"affected_timeline_item_ids":{"type":"array","items":{"type":"string"}},"created_timeline_item_ids":{"type":"array","items":{"type":"string"}},"deleted_timeline_item_ids":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"operation_id":{"type":"string","const":"timeline.item.trim"},"result":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"trim_start_units":{"type":"string"},"trim_end_units":{"type":"string"},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"message":{"type":"string"}},"required":["timeline_item_id","trim_start_units","trim_end_units","trim_start_seconds","trim_end_seconds","message"],"additionalProperties":false}},"required":["success","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","operation_id","result"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"mutation_receipt_id":{"type":"string"},"idempotency_key":{"type":"string"},"base_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"replayed":{"type":"boolean"},"txid":{"type":"integer","minimum":0,"maximum":9007199254740991},"affected_timeline_item_ids":{"type":"array","items":{"type":"string"}},"created_timeline_item_ids":{"type":"array","items":{"type":"string"}},"deleted_timeline_item_ids":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"operation_id":{"type":"string","const":"timeline.item.split"},"result":{"type":"object","properties":{"left_timeline_item_id":{"type":"string"},"right_timeline_item_id":{"type":"string"},"split_at_units":{"type":"string"},"split_at_seconds":{"type":"number"}},"required":["left_timeline_item_id","right_timeline_item_id","split_at_units","split_at_seconds"],"additionalProperties":false}},"required":["success","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","operation_id","result"],"additionalProperties":false}],"type":"object"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/timeline/operations/preview":{"post":{"operationId":"previewSequenceTimingOperation","summary":"Preview a sequence timing operation","description":"Preview a sequence timing operation.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"oneOf":[{"type":"object","properties":{"operation_id":{"type":"string","const":"timeline.item.trim"},"timeline_item_id":{"type":"string"},"trim_start_delta_seconds":{"type":"number"},"trim_end_delta_seconds":{"type":"number"},"snap_to_frame":{"type":"boolean"}},"required":["operation_id","timeline_item_id","trim_start_delta_seconds","trim_end_delta_seconds","snap_to_frame"]},{"type":"object","properties":{"operation_id":{"type":"string","const":"timeline.item.split"},"timeline_item_id":{"type":"string"},"split_at_seconds":{"type":"number","minimum":0},"snap_to_frame":{"type":"boolean"}},"required":["operation_id","timeline_item_id","split_at_seconds","snap_to_frame"]}],"type":"object"},"expected_revision":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["operation","expected_revision"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"operation_id":{"type":"string","enum":["timeline.item.trim","timeline.item.split"]},"project_id":{"type":"string"},"current_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"expected_revision":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"destructive":{"type":"boolean"},"affected_timeline_item_ids":{"type":"array","items":{"type":"string"}},"would_create_timeline_item_ids":{"type":"array","items":{"type":"string"}},"would_delete_timeline_item_ids":{"type":"array","items":{"type":"string"}},"change_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}}},"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"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/audio":{"post":{"operationId":"insertProjectTimelineAudio","summary":"Insert audio on timeline","description":"Insert audio on timeline.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"start_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"volume":{"type":"number","minimum":0,"maximum":2},"fade_in_seconds":{"type":"number","minimum":0},"fade_out_seconds":{"type":"number","minimum":0},"loop":{"type":"boolean"}},"required":["asset_id","start_seconds"]}}},"required":["items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"inserted":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"volume":{"type":"number"},"fade_in_seconds":{"type":"number"},"fade_out_seconds":{"type":"number"},"loop":{"type":"boolean"},"success":{"type":"boolean"},"message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["asset_id","timeline_item_id","start_seconds","duration_seconds","volume","fade_in_seconds","fade_out_seconds","loop","success","message"],"additionalProperties":false}},"summary":{"type":"object","properties":{"total":{"type":"number"},"inserted":{"type":"number"},"failed":{"type":"number"}},"required":["total","inserted","failed"],"additionalProperties":false},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["inserted","summary","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/audio/{timelineItemId}":{"patch":{"operationId":"updateProjectsProjectIdTimelineAudioTimelineItemId","summary":"Update audio timeline item","description":"Update audio timeline item.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_seconds":{"type":"number","exclusiveMinimum":0},"volume":{"type":"number","minimum":0,"maximum":2},"fade_in_seconds":{"type":"number","minimum":0},"fade_out_seconds":{"type":"number","minimum":0}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"timeline_item_id":{"type":"string"},"duration_seconds":{"type":"number"},"volume":{"type":"number"},"fade_in_seconds":{"type":"number"},"fade_out_seconds":{"type":"number"},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","timeline_item_id","duration_seconds","volume","fade_in_seconds","fade_out_seconds","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/audio-library/search":{"get":{"operationId":"searchAudioLibrary","summary":"Search free-to-use audio providers","description":"Search free-to-use audio providers.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"query","schema":{"type":"string","minLength":1,"maxLength":160},"required":true},{"in":"query","name":"provider","schema":{"type":"string","enum":["all","openverse","freesound","wikimedia","remotion"]}},{"in":"query","name":"license","schema":{"type":"string","enum":["cc0","public_domain","no_attribution","attribution","all"]}},{"in":"query","name":"audio_type","schema":{"type":"string","enum":["music","sound_effect","ambient","other"]}},{"in":"query","name":"min_duration_seconds","schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},{"in":"query","name":"max_duration_seconds","schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","enum":["openverse","freesound","wikimedia","remotion"]},"external_id":{"type":"string"},"title":{"type":"string"},"creator_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"creator_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"type":"string"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"license_code":{"type":"string"},"license_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"requires_attribution":{"type":"boolean"},"attribution_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"commercial_use_allowed":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}}},"required":["provider","external_id","title","creator_name","creator_url","source_url","preview_url","download_url","duration_seconds","license_code","license_url","requires_attribution","attribution_text","commercial_use_allowed","tags"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}},"providers":{"type":"array","items":{"type":"string","enum":["openverse","freesound","wikimedia","remotion"]}}},"required":["items","warnings","providers"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/audio-library/import":{"post":{"operationId":"importAudioLibraryAsset","summary":"Import provider audio into workspace media","description":"Import provider audio into workspace media.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["openverse","freesound","wikimedia","remotion"]},"external_id":{"type":"string","minLength":1},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"project_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"start_seconds":{"type":"number","minimum":0},"duration_seconds":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"volume":{"type":"number","minimum":0,"maximum":2},"fade_in_seconds":{"type":"number","minimum":0},"fade_out_seconds":{"type":"number","minimum":0},"loop":{"type":"boolean"},"audio_type":{"type":"string","enum":["music","sound_effect","ambient","other"]}},"required":["provider","external_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"asset_type":{"type":"string","const":"audio"},"audio_type":{"type":"string"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"source_url":{"type":"string"},"license_code":{"type":"string"},"license_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"attribution_text":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","asset_type","audio_type","duration_seconds","source_url","license_code","license_url","attribution_text"],"additionalProperties":false},"imported":{"type":"boolean"},"deduped":{"type":"boolean"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]},"provider_request":{"type":"object","properties":{"provider":{"type":"string","enum":["openverse","freesound","wikimedia","remotion"]},"external_id":{"type":"string"},"retryable":{"type":"boolean"},"imported_at":{"type":"string"}},"required":["provider","external_id","retryable","imported_at"],"additionalProperties":false}},"required":["asset","imported","deduped","timeline_item_id","txid","provider_request"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/stock-media/search":{"get":{"operationId":"searchStockMedia","summary":"Search vetted stock media providers","description":"Search vetted stock media providers.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"query","schema":{"type":"string","minLength":1,"maxLength":160},"required":true},{"in":"query","name":"asset_type","schema":{"type":"string","enum":["image","video","audio"]},"required":true},{"in":"query","name":"provider","schema":{"anyOf":[{"type":"string","enum":["pexels","freesound"]},{"type":"null"}]}},{"in":"query","name":"orientation","schema":{"anyOf":[{"type":"string","enum":["landscape","portrait","square"]},{"type":"null"}]}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","enum":["pexels","freesound"]},"provider_asset_id":{"type":"string"},"asset_type":{"type":"string","enum":["image","video","audio"]},"title":{"type":"string"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"type":"string"},"author_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"author_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"license_code":{"type":"string"},"license_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"requires_attribution":{"type":"boolean"},"width":{"anyOf":[{"type":"number"},{"type":"null"}]},"height":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"},"mime_type":{"type":"string"},"width":{"anyOf":[{"type":"number"},{"type":"null"}]},"height":{"anyOf":[{"type":"number"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","label","url","mime_type","width","height","quality"],"additionalProperties":false}}},"required":["provider","provider_asset_id","asset_type","title","preview_url","thumbnail_url","source_url","author_name","author_url","license_code","license_url","requires_attribution","width","height","duration_seconds","variants"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["items","warnings"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/stock-media/import":{"post":{"operationId":"importStockMedia","summary":"Import vetted stock media into workspace media","description":"Import vetted stock media into workspace media.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["pexels","freesound"]},"provider_asset_id":{"type":"string","minLength":1},"asset_type":{"type":"string","enum":["image","video","audio"]},"variant_id":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"audio_type":{"type":"string","enum":["sound_effect","ambient","background_music","other"]}},"required":["provider","provider_asset_id","asset_type"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"asset_type":{"type":"string","enum":["image","video","audio"]},"processing_status":{"type":"string"},"source_url":{"type":"string"},"license_code":{"type":"string"},"license_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","asset_type","processing_status","source_url","license_code","license_url"],"additionalProperties":false},"imported":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["asset","imported","deduped"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/library/broll/search":{"get":{"operationId":"searchGlobalBrollLibrary","summary":"Search the BlitzReels global B-roll library","description":"Search the BlitzReels global B-roll library.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"query","schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]}},{"in":"query","name":"asset_type","schema":{"anyOf":[{"type":"string","enum":["image","video","audio"]},{"type":"null"}]}},{"in":"query","name":"audio_type","schema":{"anyOf":[{"type":"string","enum":["music","sound_effect","ambient","background_music","other"]},{"type":"null"}]}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"asset_type":{"type":"string","enum":["image","video","audio"]},"title":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"mime_type":{"type":"string"},"file_size_bytes":{"type":"number"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"width":{"anyOf":[{"type":"number"},{"type":"null"}]},"height":{"anyOf":[{"type":"number"},{"type":"null"}]},"audio_type":{"type":"string","enum":["music","sound_effect","ambient","background_music","other"]},"license_code":{"type":"string"},"license_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"requires_attribution":{"type":"boolean"},"attribution_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","asset_type","title","description","tags","preview_url","thumbnail_url","mime_type","file_size_bytes","duration_seconds","width","height","audio_type","license_code","license_url","requires_attribution","attribution_text","source_url"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/library/broll/{libraryAssetId}/import":{"post":{"operationId":"importGlobalBrollLibraryAsset","summary":"Import a global B-roll library asset into workspace media","description":"Import a global B-roll library asset into workspace media.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"libraryAssetId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"asset_type":{"type":"string","enum":["image","video","audio"]},"processing_status":{"type":"string"},"library_asset_id":{"type":"string"}},"required":["id","name","asset_type","processing_status","library_asset_id"],"additionalProperties":false},"imported":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["asset","imported","deduped"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/silence/plan":{"post":{"operationId":"planProjectSilenceRemoval","summary":"Preview a silence removal plan","description":"Preview a silence removal plan.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"strategy":{"default":"audio","type":"string","enum":["audio","caption-gaps"]},"padding_ms":{"default":250,"type":"number","minimum":0,"maximum":2000},"silence_threshold_db":{"default":-35,"type":"number"},"min_silence_duration_seconds":{"default":0.5,"type":"number"},"remove_blips_max_duration_seconds":{"default":0,"type":"number","minimum":0,"maximum":2},"use_caption_validation":{"default":false,"type":"boolean"}},"required":["timeline_item_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"job_id":{"type":"string"},"status":{"type":"string","const":"queued"},"status_url":{"type":"string"}},"required":["job_id","status","status_url"],"additionalProperties":false},{"type":"object","properties":{"timelineItemId":{"type":"string"},"strategy":{"type":"string","const":"caption-gaps"},"segments":{"type":"array","items":{"type":"object","properties":{"timelineItemId":{"type":"string"},"label":{"type":"string"},"type":{"type":"string","const":"silence"},"trimStartSeconds":{"type":"number"},"trimEndSeconds":{"type":"number"},"durationSeconds":{"type":"number"}},"required":["timelineItemId","label","type","trimStartSeconds","trimEndSeconds","durationSeconds"],"additionalProperties":false}},"silentSegmentIndices":{"type":"array","items":{"type":"number"}},"summary":{"type":"object","properties":{"analyzedCount":{"type":"number"},"silenceCount":{"type":"number"},"cutDurationSeconds":{"type":"number"}},"required":["analyzedCount","silenceCount","cutDurationSeconds"],"additionalProperties":false}},"required":["timelineItemId","strategy","segments","silentSegmentIndices","summary"],"additionalProperties":false}]}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/silence/apply":{"post":{"operationId":"applyProjectSilenceRemoval","summary":"Apply a reviewed silence removal plan","description":"Apply a reviewed silence removal plan.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"all_media_items":{"default":false,"type":"boolean"},"padding_ms":{"default":250,"type":"number","minimum":0,"maximum":2000},"silence_threshold_db":{"default":-35,"type":"number"},"min_silence_duration_seconds":{"default":0.5,"type":"number"},"remove_blips_max_duration_seconds":{"default":0,"type":"number","minimum":0,"maximum":2},"use_caption_validation":{"default":false,"type":"boolean"},"delete_silent_clips":{"default":true,"type":"boolean"},"manual_segment_overrides":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["keep","cut"]}},"segments":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0}},"required":["start_seconds","end_seconds"]}},"reviewed_plan":{"type":"object","properties":{"timelineItemId":{"type":"string"},"startUnits":{"type":"string"},"endUnits":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991},"startUnits":{"type":"string"},"endUnits":{"type":"string"},"durationUnits":{"type":"string"},"kind":{"type":"string","enum":["keep","cut"]}},"required":["index","startUnits","endUnits","durationUnits","kind"]}}},"required":["timelineItemId","startUnits","endUnits","segments"]},"preview_confirmed":{"type":"boolean","const":true}},"required":["preview_confirmed"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"session_id":{"type":"string"},"applied_count":{"type":"number"},"timeline_item_id":{"type":"string"},"timeline_item_ids":{"type":"array","items":{"type":"string"}},"result":{},"results":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"result":{}},"required":["timeline_item_id","result"],"additionalProperties":false}}},"required":["session_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/mistakes/plan":{"post":{"operationId":"planProjectMistakeRemoval","summary":"Preview a mistake removal plan","description":"Preview a mistake removal plan.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"}},"required":["timeline_item_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"timelineItemId":{"type":"string"},"mediaAssetId":{"type":"string"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"analyzedSegments":{"type":"array","items":{"type":"object","properties":{"timelineItemId":{"type":"string"},"label":{"type":"string"},"verdict":{"type":"string","enum":["mistake","keeper","uncertain"]},"confidence":{"type":"number","minimum":0,"maximum":1},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcriptPreview":{"type":"string"},"trimStartSeconds":{"type":"number"},"trimEndSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"mediaAssetId":{"type":"string"}},"required":["timelineItemId","label","verdict","transcriptPreview","trimStartSeconds","trimEndSeconds","durationSeconds","mediaAssetId"],"additionalProperties":false}},"segments":{"type":"array","items":{"type":"object","properties":{"timelineItemId":{"type":"string"},"label":{"type":"string"},"verdict":{"type":"string","enum":["mistake","keeper","uncertain"]},"confidence":{"type":"number","minimum":0,"maximum":1},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcriptPreview":{"type":"string"},"trimStartSeconds":{"type":"number"},"trimEndSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"mediaAssetId":{"type":"string"}},"required":["timelineItemId","label","verdict","transcriptPreview","trimStartSeconds","trimEndSeconds","durationSeconds","mediaAssetId"],"additionalProperties":false}},"summary":{"type":"object","properties":{"analyzedCount":{"type":"number"},"mistakeCount":{"type":"number"}},"required":["analyzedCount","mistakeCount"],"additionalProperties":false},"model":{"type":"string"}},"required":["timelineItemId","mediaAssetId","videoUrl","summary"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/mistakes/apply":{"post":{"operationId":"applyProjectMistakeRemoval","summary":"Apply a reviewed mistake removal plan","description":"Apply a reviewed mistake removal plan.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"plan":{"type":"object","properties":{"timelineItemId":{"type":"string"},"mediaAssetId":{"type":"string"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"analyzedSegments":{"type":"array","items":{"type":"object","properties":{"timelineItemId":{"type":"string"},"label":{"type":"string"},"verdict":{"type":"string","enum":["mistake","keeper","uncertain"]},"confidence":{"type":"number","minimum":0,"maximum":1},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcriptPreview":{"type":"string"},"trimStartSeconds":{"type":"number"},"trimEndSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"mediaAssetId":{"type":"string"}},"required":["timelineItemId","label","verdict","transcriptPreview","trimStartSeconds","trimEndSeconds","durationSeconds","mediaAssetId"]}},"segments":{"type":"array","items":{"type":"object","properties":{"timelineItemId":{"type":"string"},"label":{"type":"string"},"verdict":{"type":"string","enum":["mistake","keeper","uncertain"]},"confidence":{"type":"number","minimum":0,"maximum":1},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcriptPreview":{"type":"string"},"trimStartSeconds":{"type":"number"},"trimEndSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"mediaAssetId":{"type":"string"}},"required":["timelineItemId","label","verdict","transcriptPreview","trimStartSeconds","trimEndSeconds","durationSeconds","mediaAssetId"]}},"summary":{"type":"object","properties":{"analyzedCount":{"type":"number"},"mistakeCount":{"type":"number"}},"required":["analyzedCount","mistakeCount"]},"model":{"type":"string"}},"required":["timelineItemId","mediaAssetId","videoUrl","summary"]},"manual_verdicts":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["mistake","keeper","uncertain"]}},"delete_mistakes":{"default":true,"type":"boolean"},"preview_confirmed":{"type":"boolean","const":true}},"required":["timeline_item_id","preview_confirmed"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"mistakeTimelineItemIds":{"type":"array","items":{"type":"string"}},"clearedTimelineItemIds":{"type":"array","items":{"type":"string"}},"txids":{"type":"array","items":{"type":"number"}},"summary":{"type":"object","properties":{"analyzedCount":{"type":"number"},"mistakeCount":{"type":"number"}},"required":["analyzedCount","mistakeCount"],"additionalProperties":false},"deletionResult":{"anyOf":[{"type":"object","properties":{"deletedCount":{"type":"number"},"deletedCaptionTimelineItemCount":{"type":"number"},"deletedWordCount":{"type":"number"},"adjustedCaptionCount":{"type":"number"}},"required":["deletedCount","deletedCaptionTimelineItemCount","deletedWordCount","adjustedCaptionCount"],"additionalProperties":false},{"type":"null"}]}},"required":["success","mistakeTimelineItemIds","clearedTimelineItemIds","txids","summary","deletionResult"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/effects/zoom":{"post":{"operationId":"addProjectZoomEffect","summary":"Add a zoom effect","description":"Add a zoom effect.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"name":{"type":"string"},"start_time_seconds":{"default":0,"type":"number","minimum":0},"duration_seconds":{"default":1,"type":"number","exclusiveMinimum":0},"easing":{"default":"easeInOut","type":"string","enum":["linear","easeIn","easeOut","easeInOut"]},"layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"order_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"scale":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"translate":{"type":"object","properties":{"start":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]},"end":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"required":["start","end"]},"anchor":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]},"style":{"type":"string","enum":["transition","hard"]},"phase":{"type":"string","enum":["in","out","both","none"]},"inDurationSeconds":{"type":"number","exclusiveMinimum":0},"outDurationSeconds":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"outScale":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"effect_type":{"type":"string","enum":["zoom","mask","colorgrade","transition","remotion"]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","project_id","timeline_item_id","content_item_id","effect_id","effect_type","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/effects/zoom/{timelineItemId}":{"patch":{"operationId":"updateProjectZoomEffect","summary":"Update a zoom effect","description":"Update a zoom effect.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_seconds":{"type":"number","exclusiveMinimum":0},"easing":{"type":"string","enum":["linear","easeIn","easeOut","easeInOut"]},"settings":{"type":"object","properties":{"scale":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"translate":{"type":"object","properties":{"start":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]},"end":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"required":["start","end"]},"anchor":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]},"style":{"type":"string","enum":["transition","hard"]},"phase":{"type":"string","enum":["in","out","both","none"]},"inDurationSeconds":{"type":"number","exclusiveMinimum":0},"outDurationSeconds":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"outScale":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"effect_type":{"type":"string","enum":["zoom","mask","colorgrade","transition","remotion"]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","project_id","timeline_item_id","content_item_id","effect_id","effect_type","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/effects/mask":{"post":{"operationId":"addProjectMaskEffect","summary":"Add a mask effect","description":"Add a mask effect.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"name":{"type":"string"},"start_time_seconds":{"default":0,"type":"number","minimum":0},"duration_seconds":{"default":1,"type":"number","exclusiveMinimum":0},"easing":{"default":"easeInOut","type":"string","enum":["linear","easeIn","easeOut","easeInOut"]},"layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"order_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"shape":{"type":"string","enum":["rectangle","rounded","ellipse","circle"]},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}}},"size":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"}}},"rotation":{"type":"number"},"feather":{"type":"number","minimum":0,"maximum":400},"blur":{"type":"number","minimum":0,"maximum":400},"opacity":{"type":"number","minimum":0,"maximum":1},"invert":{"type":"boolean"},"cornerRadius":{"type":"number","minimum":0,"maximum":512},"edgeFalloff":{"type":"string","enum":["linear","smooth","sharp"]},"blendMode":{"type":"string","enum":["normal","multiply","screen","overlay","softLight"]},"shadow":{"type":"object","properties":{"enabled":{"type":"boolean"},"offsetX":{"type":"number"},"offsetY":{"type":"number"},"blur":{"type":"number","minimum":0,"maximum":400},"spread":{"type":"number","minimum":0,"maximum":200},"color":{"type":"string"},"opacity":{"type":"number","minimum":0,"maximum":1}}}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"effect_type":{"type":"string","enum":["zoom","mask","colorgrade","transition","remotion"]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","project_id","timeline_item_id","content_item_id","effect_id","effect_type","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/effects/mask/{timelineItemId}":{"patch":{"operationId":"updateProjectMaskEffect","summary":"Update a mask effect","description":"Update a mask effect.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_seconds":{"type":"number","exclusiveMinimum":0},"easing":{"type":"string","enum":["linear","easeIn","easeOut","easeInOut"]},"settings":{"type":"object","properties":{"shape":{"type":"string","enum":["rectangle","rounded","ellipse","circle"]},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}}},"size":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"}}},"rotation":{"type":"number"},"feather":{"type":"number","minimum":0,"maximum":400},"blur":{"type":"number","minimum":0,"maximum":400},"opacity":{"type":"number","minimum":0,"maximum":1},"invert":{"type":"boolean"},"cornerRadius":{"type":"number","minimum":0,"maximum":512},"edgeFalloff":{"type":"string","enum":["linear","smooth","sharp"]},"blendMode":{"type":"string","enum":["normal","multiply","screen","overlay","softLight"]},"shadow":{"type":"object","properties":{"enabled":{"type":"boolean"},"offsetX":{"type":"number"},"offsetY":{"type":"number"},"blur":{"type":"number","minimum":0,"maximum":400},"spread":{"type":"number","minimum":0,"maximum":200},"color":{"type":"string"},"opacity":{"type":"number","minimum":0,"maximum":1}}}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"effect_type":{"type":"string","enum":["zoom","mask","colorgrade","transition","remotion"]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","project_id","timeline_item_id","content_item_id","effect_id","effect_type","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/effects/colorgrade":{"post":{"operationId":"addProjectColorGradeEffect","summary":"Add a color grade effect","description":"Add a color grade effect.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"name":{"type":"string"},"start_time_seconds":{"default":0,"type":"number","minimum":0},"duration_seconds":{"default":1,"type":"number","exclusiveMinimum":0},"easing":{"default":"easeInOut","type":"string","enum":["linear","easeIn","easeOut","easeInOut"]},"layer_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"order_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"lutEnabled":{"type":"boolean"},"lutPreset":{"anyOf":[{"type":"string"},{"type":"null"}]},"lutCustomUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lutIntensity":{"type":"number","minimum":0,"maximum":1},"brightness":{"type":"number","minimum":0.5,"maximum":1.5},"contrast":{"type":"number","minimum":0.5,"maximum":1.5},"saturation":{"type":"number","minimum":0,"maximum":2},"temperature":{"type":"number","minimum":-100,"maximum":100},"tint":{"type":"number","minimum":-100,"maximum":100},"grainEnabled":{"type":"boolean"},"grainIntensity":{"type":"number","minimum":0,"maximum":1},"grainSize":{"type":"number","minimum":0.5,"maximum":3},"grainAnimated":{"type":"boolean"},"noiseEnabled":{"type":"boolean"},"noiseIntensity":{"type":"number","minimum":0,"maximum":1},"noiseType":{"type":"string","enum":["static","scanlines","rgb"]},"vignetteEnabled":{"type":"boolean"},"vignetteIntensity":{"type":"number","minimum":0,"maximum":1},"vignetteSize":{"type":"number","minimum":0,"maximum":1},"vignetteSoftness":{"type":"number","minimum":0,"maximum":1},"fadeToBlack":{"type":"number","minimum":0,"maximum":1},"fadeToWhite":{"type":"number","minimum":0,"maximum":1}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"effect_type":{"type":"string","enum":["zoom","mask","colorgrade","transition","remotion"]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","project_id","timeline_item_id","content_item_id","effect_id","effect_type","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/effects/colorgrade/{timelineItemId}":{"patch":{"operationId":"updateProjectColorGradeEffect","summary":"Update a color grade effect","description":"Update a color grade effect.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_seconds":{"type":"number","exclusiveMinimum":0},"easing":{"type":"string","enum":["linear","easeIn","easeOut","easeInOut"]},"settings":{"type":"object","properties":{"lutEnabled":{"type":"boolean"},"lutPreset":{"anyOf":[{"type":"string"},{"type":"null"}]},"lutCustomUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lutIntensity":{"type":"number","minimum":0,"maximum":1},"brightness":{"type":"number","minimum":0.5,"maximum":1.5},"contrast":{"type":"number","minimum":0.5,"maximum":1.5},"saturation":{"type":"number","minimum":0,"maximum":2},"temperature":{"type":"number","minimum":-100,"maximum":100},"tint":{"type":"number","minimum":-100,"maximum":100},"grainEnabled":{"type":"boolean"},"grainIntensity":{"type":"number","minimum":0,"maximum":1},"grainSize":{"type":"number","minimum":0.5,"maximum":3},"grainAnimated":{"type":"boolean"},"noiseEnabled":{"type":"boolean"},"noiseIntensity":{"type":"number","minimum":0,"maximum":1},"noiseType":{"type":"string","enum":["static","scanlines","rgb"]},"vignetteEnabled":{"type":"boolean"},"vignetteIntensity":{"type":"number","minimum":0,"maximum":1},"vignetteSize":{"type":"number","minimum":0,"maximum":1},"vignetteSoftness":{"type":"number","minimum":0,"maximum":1},"fadeToBlack":{"type":"number","minimum":0,"maximum":1},"fadeToWhite":{"type":"number","minimum":0,"maximum":1}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"content_item_id":{"type":"string"},"effect_id":{"type":"string"},"effect_type":{"type":"string","enum":["zoom","mask","colorgrade","transition","remotion"]},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","project_id","timeline_item_id","content_item_id","effect_id","effect_type","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/media":{"post":{"operationId":"createProjectsProjectIdTimelineMedia","summary":"Insert media on timeline","description":"Insert media on timeline.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"start_seconds":{"type":"number","minimum":0},"duration_seconds":{"anyOf":[{"type":"number","minimum":0.5},{"type":"null"}]},"layer_index":{"type":"integer","minimum":0,"maximum":20},"placement_intent":{"type":"string","enum":["overlay","background","exact"]},"position_preset":{"type":"string","enum":["center","fullscreen","top-half","bottom-half","pip-top-left","pip-top-right","pip-bottom-left","pip-bottom-right"]},"position_x":{"type":"number","minimum":-2000,"maximum":2000},"position_y":{"type":"number","minimum":-2000,"maximum":2000},"width_px":{"type":"number","minimum":1},"height_px":{"type":"number","minimum":1},"keep_aspect_ratio":{"type":"boolean"},"scale":{"type":"number","minimum":0.1,"maximum":3},"opacity":{"type":"number","minimum":0,"maximum":1},"volume":{"type":"number","minimum":0,"maximum":2},"animation_preset":{"type":"string","enum":["none","fadeIn","fadeOut","zoomIn","zoomOut","slideLeft","slideRight","slideUp","slideDown","popIn","bounce","spin"]}},"required":["asset_id","start_seconds"]}},"allow_duplicate":{"type":"boolean"}},"required":["items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"inserted":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"start_seconds":{"type":"number"},"success":{"type":"boolean"},"already_existed":{"type":"boolean"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"animation_applied":{"anyOf":[{"type":"string"},{"type":"null"}]},"layer_index":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"placement_intent":{"type":"string","enum":["overlay","background","exact"]},"placement":{"anyOf":[{"type":"object","properties":{"coordinate_origin":{"type":"string","const":"canvas_center"},"position_x":{"type":"number"},"position_y":{"type":"number"},"width_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"height_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"composition_width":{"type":"number"},"composition_height":{"type":"number"},"keep_aspect_ratio":{"type":"boolean"},"position_preset":{"anyOf":[{"type":"string"},{"type":"null"}]},"explicit_layer_preserved":{"type":"boolean"}},"required":["coordinate_origin","position_x","position_y","width_px","height_px","composition_width","composition_height","keep_aspect_ratio","position_preset","explicit_layer_preserved"],"additionalProperties":false},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["asset_id","start_seconds","success","already_existed","timeline_item_id","message","animation_applied","layer_index","placement"],"additionalProperties":false}},"summary":{"type":"object","properties":{"total":{"type":"number"},"actually_inserted":{"type":"number"},"already_in_timeline":{"type":"number"},"failed":{"type":"number"}},"required":["total","actually_inserted","already_in_timeline","failed"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["inserted","summary","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/broll":{"post":{"operationId":"createProjectsProjectIdBroll","summary":"Insert B-roll items","description":"Insert B-roll items.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"start_seconds":{"type":"number","minimum":0},"duration_seconds":{"anyOf":[{"type":"number","minimum":0.5},{"type":"null"}]},"layer_index":{"type":"integer","minimum":0,"maximum":20},"placement_intent":{"type":"string","enum":["overlay","background","exact"]},"position_preset":{"type":"string","enum":["center","fullscreen","top-half","bottom-half","pip-top-left","pip-top-right","pip-bottom-left","pip-bottom-right"]},"position_x":{"type":"number","minimum":-2000,"maximum":2000},"position_y":{"type":"number","minimum":-2000,"maximum":2000},"width_px":{"type":"number","minimum":1},"height_px":{"type":"number","minimum":1},"keep_aspect_ratio":{"type":"boolean"},"scale":{"type":"number","minimum":0.1,"maximum":3},"opacity":{"type":"number","minimum":0,"maximum":1},"volume":{"type":"number","minimum":0,"maximum":2},"animation_preset":{"type":"string","enum":["none","fadeIn","fadeOut","zoomIn","zoomOut","slideLeft","slideRight","slideUp","slideDown","popIn","bounce","spin"]}},"required":["asset_id","start_seconds"]}},"allow_duplicate":{"type":"boolean"}},"required":["items"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"inserted":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"start_seconds":{"type":"number"},"success":{"type":"boolean"},"already_existed":{"type":"boolean"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"animation_applied":{"anyOf":[{"type":"string"},{"type":"null"}]},"layer_index":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"placement_intent":{"type":"string","enum":["overlay","background","exact"]},"placement":{"anyOf":[{"type":"object","properties":{"coordinate_origin":{"type":"string","const":"canvas_center"},"position_x":{"type":"number"},"position_y":{"type":"number"},"width_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"height_px":{"anyOf":[{"type":"number"},{"type":"null"}]},"composition_width":{"type":"number"},"composition_height":{"type":"number"},"keep_aspect_ratio":{"type":"boolean"},"position_preset":{"anyOf":[{"type":"string"},{"type":"null"}]},"explicit_layer_preserved":{"type":"boolean"}},"required":["coordinate_origin","position_x","position_y","width_px","height_px","composition_width","composition_height","keep_aspect_ratio","position_preset","explicit_layer_preserved"],"additionalProperties":false},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["asset_id","start_seconds","success","already_existed","timeline_item_id","message","animation_applied","layer_index","placement"],"additionalProperties":false}},"summary":{"type":"object","properties":{"total":{"type":"number"},"actually_inserted":{"type":"number"},"already_in_timeline":{"type":"number"},"failed":{"type":"number"}},"required":["total","actually_inserted","already_in_timeline","failed"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["inserted","summary","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/timeline/media/{timelineItemId}":{"patch":{"operationId":"updateProjectsProjectIdTimelineMediaTimelineItemId","summary":"Update media overlay transform","description":"Update media overlay transform.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"timelineItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"position_preset":{"type":"string","enum":["center","fullscreen","top-half","bottom-half","pip-top-left","pip-top-right","pip-bottom-left","pip-bottom-right"]},"position_x":{"type":"number","minimum":-2000,"maximum":2000},"position_y":{"type":"number","minimum":-2000,"maximum":2000},"width_px":{"type":"number","minimum":1},"height_px":{"type":"number","minimum":1},"keep_aspect_ratio":{"type":"boolean"},"scale":{"type":"number","minimum":0.1,"maximum":3},"opacity":{"type":"number","minimum":0,"maximum":1},"animation_preset":{"type":"string","enum":["none","fadeIn","fadeOut","zoomIn","zoomOut","slideLeft","slideRight","slideUp","slideDown","popIn","bounce","spin"]},"remove_animations":{"type":"boolean"},"blurred_background":{"type":"boolean"},"volume":{"type":"number","minimum":0,"maximum":2}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"success":{"type":"boolean","const":true},"timelineItemId":{"type":"string"},"updated":{"type":"object","properties":{"positionX":{"type":"number"},"positionY":{"type":"number"},"widthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"heightPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"keepAspectRatio":{"type":"boolean"},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"blurredBackground":{"type":"boolean"},"volume":{"type":"number"}},"required":["positionX","positionY","widthPx","heightPx","keepAspectRatio","opacity","blurredBackground","volume"],"additionalProperties":false},"animationApplied":{"anyOf":[{"type":"string"},{"type":"null"}]},"keyframeCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success","timelineItemId","updated","animationApplied","keyframeCount","warnings","message"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}],"type":"object"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/carousels/generate":{"post":{"operationId":"createProjectsProjectIdCarouselsGenerate","summary":"Generate carousel slides in one call","description":"Generate carousel slides in one call.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clear_existing":{"type":"boolean"},"slide_duration_seconds":{"type":"number","minimum":0.5,"maximum":30},"background_strategy":{"type":"string","enum":["solid","gradient","image","mixed"]},"image_model_id":{"type":"string","enum":["fal-ai/gpt-image-1","fal-ai/gpt-image-1.5","fal-ai/gpt-image-2","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"]},"slides":{"minItems":1,"maxItems":35,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"body":{"type":"string","minLength":1,"maxLength":500},"logos":{"maxItems":6,"type":"array","items":{"type":"string","enum":["codex","chatgpt","openai","claude","github","copilot"]}},"background_image_url":{"type":"string","format":"uri"},"background_prompt":{"type":"string","minLength":3,"maxLength":1000},"background_color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}}}}},"required":["slides"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"slide_count":{"type":"number"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"ai_image_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"timeline_item_ids":{"type":"array","items":{"type":"string"}},"overlay_ids":{"type":"array","items":{"type":"string"}},"fill_layer_ids":{"type":"array","items":{"type":"string"}},"ai_asset_ids":{"type":"array","items":{"type":"string"}},"logo_asset_ids":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["project_id","slide_count","job_id","ai_image_run_id","timeline_item_ids","overlay_ids","fill_layer_ids","ai_asset_ids","logo_asset_ids","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/characters/{characterId}/references":{"post":{"operationId":"createCharactersCharacterIdReferences","summary":"Add character reference images","description":"Add character reference images.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"characterId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_ids":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["asset_ids"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"added_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"requested_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"skipped_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"character":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}},"required":["added_count","requested_count","skipped_count","character"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/characters/{characterId}/primary-reference":{"post":{"operationId":"createCharactersCharacterIdPrimaryReference","summary":"Set primary character reference","description":"Set primary character reference.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"characterId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["asset_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/characters/{characterId}/archive":{"post":{"operationId":"createCharactersCharacterIdArchive","summary":"Archive workspace character","description":"Archive workspace character.","tags":["AI Generation"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"characterId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retry key (8-200 characters). Reusing it with identical input returns the original response; different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9._:-]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"type":{"type":"string","enum":["human","fictional","other"]},"status":{"type":"string","enum":["draft","ready","training","failed","archived"]},"consistency_mode":{"type":"string","enum":["reference","trained_lora"]},"species":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"story_facts":{"type":"array","items":{"type":"string"}},"default_voice_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"default_voice_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"primary_reference_asset_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"references":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"order_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_primary":{"type":"boolean"}},"required":["asset_id","name","order_index","is_primary"],"additionalProperties":false}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","type","status","consistency_mode","species","canonical_description","story_facts","default_voice_id","default_voice_style","folder_id","primary_reference_asset_id","references","created_at","updated_at"],"additionalProperties":false}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}},"headers":{"Mutation-Receipt-Id":{"description":"Durable mutation receipt identifier.","schema":{"type":"string","format":"uuid"}},"Idempotency-Replayed":{"description":"True when this response was replayed from a prior request.","schema":{"type":"boolean"}}}}}}},"/projects/{projectId}/captions/hydrate":{"post":{"operationId":"createProjectsProjectIdCaptionsHydrate","summary":"Restore project captions from the canonical transcript","description":"Restore project captions from the canonical transcript.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"}},"required":["asset_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"project_id":{"type":"string"},"asset_id":{"type":"string"},"promoted":{"type":"boolean"},"caption_count":{"type":"number"},"captions_added":{"type":"number"},"deleted_caption_timeline_items":{"type":"number"},"txid":{"type":"number"}},"required":["success","project_id","asset_id","promoted","caption_count","captions_added","deleted_caption_timeline_items","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/audio-levels":{"get":{"operationId":"getProjectsProjectIdAudioLevels","summary":"Get audio levels for timeline item","description":"Get audio levels for timeline item.","tags":["Project Context"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"timeline_item_id","schema":{"type":"string"},"required":true},{"in":"query","name":"silence_threshold","schema":{"type":"number"}},{"in":"query","name":"min_silence_duration","schema":{"type":"number"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalDurationSeconds":{"type":"number"},"regions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["speech","silence"]},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"durationSeconds":{"type":"number"}},"required":["type","startSeconds","endSeconds","durationSeconds"],"additionalProperties":false}},"speechDurationSeconds":{"type":"number"},"silenceDurationSeconds":{"type":"number"},"speechPercentage":{"type":"number"}},"required":["totalDurationSeconds","regions","speechDurationSeconds","silenceDurationSeconds","speechPercentage"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/transcript/segments":{"get":{"operationId":"getProjectsProjectIdTranscriptSegments","summary":"Get transcript segments","description":"Get transcript segments.","tags":["Project Context"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"chunk_strategy","schema":{"type":"string","enum":["sentence","paragraph","time-window"]}},{"in":"query","name":"max_chunk_seconds","schema":{"type":"number"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalSegments":{"type":"number"},"totalWords":{"type":"number"},"totalDurationSeconds":{"type":"number"},"segments":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"startSeconds":{"type":"number"},"endSeconds":{"type":"number"},"durationSeconds":{"type":"number"},"wordCount":{"type":"number"}},"required":["text","startSeconds","endSeconds","durationSeconds","wordCount"],"additionalProperties":false}}},"required":["totalSegments","totalWords","totalDurationSeconds","segments"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/delete":{"post":{"operationId":"createProjectsProjectIdCaptionsDelete","summary":"Delete caption timeline items","description":"Delete caption timeline items.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"all":{"type":"boolean"},"caption_id":{"type":"string"},"timeline_item_id":{"type":"string"},"from_seconds":{"type":"number","minimum":0},"to_seconds":{"type":"number","minimum":0}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"action":{"type":"string","enum":["delete","hide","show"]},"affected_count":{"type":"number"},"caption_ids":{"type":"array","items":{"type":"string"}},"timeline_item_ids":{"type":"array","items":{"type":"string"}},"warnings":{"default":[],"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success","action","affected_count","caption_ids","timeline_item_ids","warnings","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/hide":{"post":{"operationId":"createProjectsProjectIdCaptionsHide","summary":"Hide caption timeline items","description":"Hide caption timeline items.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"all":{"type":"boolean"},"caption_id":{"type":"string"},"timeline_item_id":{"type":"string"},"from_seconds":{"type":"number","minimum":0},"to_seconds":{"type":"number","minimum":0}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"action":{"type":"string","enum":["delete","hide","show"]},"affected_count":{"type":"number"},"caption_ids":{"type":"array","items":{"type":"string"}},"timeline_item_ids":{"type":"array","items":{"type":"string"}},"warnings":{"default":[],"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success","action","affected_count","caption_ids","timeline_item_ids","warnings","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/show":{"post":{"operationId":"createProjectsProjectIdCaptionsShow","summary":"Show caption timeline items","description":"Show caption timeline items.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"all":{"type":"boolean"},"caption_id":{"type":"string"},"timeline_item_id":{"type":"string"},"from_seconds":{"type":"number","minimum":0},"to_seconds":{"type":"number","minimum":0}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"action":{"type":"string","enum":["delete","hide","show"]},"affected_count":{"type":"number"},"caption_ids":{"type":"array","items":{"type":"string"}},"timeline_item_ids":{"type":"array","items":{"type":"string"}},"warnings":{"default":[],"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success","action","affected_count","caption_ids","timeline_item_ids","warnings","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/transcript/corrections":{"post":{"operationId":"createProjectsProjectIdTranscriptCorrections","summary":"Bulk replace transcript words","description":"Bulk replace transcript words.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_asset_id":{"type":"string"},"timeline_item_id":{"type":"string"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1},"to":{"type":"string","minLength":1},"match_case":{"type":"boolean"},"match_whole_word":{"type":"boolean"}},"required":["from","to"]}},"phrase_replacements":{"type":"array","items":{"type":"object","properties":{"from_words":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"to_words":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"match_case":{"type":"boolean"}},"required":["from_words","to_words"]}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"asset_id":{"type":"string"},"updated_segments":{"type":"number"},"updated_words":{"type":"number"},"replacements_applied":{"type":"number"},"unmatched_phrase_replacements":{"type":"array","items":{"type":"object","properties":{"from_words":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"to_words":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"match_case":{"type":"boolean"}},"required":["from_words","to_words"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","asset_id","updated_segments","updated_words","replacements_applied","unmatched_phrase_replacements"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-presets":{"get":{"operationId":"getCaptionPresets","summary":"List legacy caption preset aliases","description":"List legacy caption preset aliases.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"presets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name","description","settings"],"additionalProperties":false}},"total":{"type":"number"}},"required":["presets","total"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-looks":{"get":{"operationId":"listCaptionLooks","summary":"List caption looks","description":"List caption looks.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"looks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name","description","settings"],"additionalProperties":false}},"total":{"type":"number"}},"required":["looks","total"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/style":{"get":{"operationId":"getProjectsProjectIdCaptionsStyle","summary":"Get caption style","description":"Get caption style.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"settings":{"type":"object","properties":{"fontSize":{"type":"number"},"fontFamily":{"type":"string"},"fontWeight":{"type":"string"},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textAlign":{"type":"string"},"lineHeight":{"type":"number"},"letterSpacing":{"type":"number"},"wordSpacingPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"color":{"type":"string"},"backgroundColor":{"type":"string"},"backgroundShape":{"type":"string","enum":["per-line","block"]},"backgroundJoinStyle":{"anyOf":[{"type":"string","enum":["connected","reverse-radius"]},{"type":"null"}]},"borderRadius":{"type":"number"},"border":{"type":"string"},"paddingPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"paddingXPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"paddingYPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textFillStyle":{"type":"string","enum":["solid","gradient"]},"textGradientFrom":{"type":"string"},"textGradientTo":{"type":"string"},"textGradientAngleDeg":{"type":"number"},"textGradientStops":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientColorSpace":{"anyOf":[{"type":"string","enum":["srgb","oklch","hsl","lab"]},{"type":"null"}]},"textStrokeEnabled":{"type":"boolean"},"textStrokeColor":{"type":"string"},"textStrokeWidthPx":{"type":"number"},"textStrokeBlurPx":{"type":"number"},"textShadow":{"type":"string"},"shadowMode":{"anyOf":[{"type":"string","enum":["text-shadow","drop-shadow"]},{"type":"null"}]},"position":{"type":"string"},"customPositionY":{"anyOf":[{"type":"number"},{"type":"null"}]},"showActiveWord":{"type":"boolean"},"activeWordColor":{"type":"string"},"activeWordBackgroundColor":{"type":"string"},"activeWordAnimation":{"type":"string"},"activeWordHoldMs":{"type":"number"},"emojiOverlaySizePx":{"anyOf":[{"type":"number"},{"type":"null"}]},"showEmojiOverlay":{"type":"boolean"},"wordRevealAnimation":{"type":"string"},"revealMode":{"type":"string","enum":["single","sequential","static"]},"paragraphReveal":{"type":"string","enum":["sequential","static"]},"paragraphMode":{"type":"string","enum":["off","auto","manual"]},"paragraphTransition":{"type":"string","enum":["fade","slide-up"]},"paragraphFadeMs":{"type":"number"},"pageCombineMs":{"type":"number"},"textTransform":{"type":"string","enum":["none","uppercase"]},"maxLinesPerCaption":{"type":"number"},"wordsPerLineLimit":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundFillStyle":{"type":"string","enum":["solid","gradient"]},"backgroundGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundGlowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundGlowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"marginBottomPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emphasisEnabled":{"type":"boolean"},"emphasisFontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"emphasisColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"emphasisScale":{"anyOf":[{"type":"number"},{"type":"null"}]},"emphasisFontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"emphasisBackgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"emphasisStrokeEnabled":{"type":"boolean"},"emphasisStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"emphasisStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emphasisGlowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"emphasisGlowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emphasisRotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"emphasisAnimation":{"anyOf":[{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},{"type":"null"}]}},"required":["fontSize","fontFamily","fontWeight","textAlign","lineHeight","letterSpacing","color","backgroundColor","borderRadius","textStrokeEnabled","textStrokeColor","textStrokeWidthPx","textStrokeBlurPx","textShadow","position","customPositionY","showActiveWord","activeWordColor","activeWordBackgroundColor","activeWordAnimation","wordRevealAnimation","maxLinesPerCaption","wordsPerLineLimit"],"additionalProperties":false},"look_id":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"preset_id":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"hint":{"type":"string"}},"required":["success","settings","look_id","preset_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateProjectsProjectIdCaptionsStyle","summary":"Update caption style","description":"Update caption style.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"look_id":{"type":"string"},"preset_id":{"type":"string"},"clear_word_overrides":{"type":"boolean"},"style":{"default":{},"type":"object","properties":{"fontSize":{"description":"Font size in pixels (16-120).","type":"integer","minimum":16,"maximum":120},"fontFamily":{"description":"Font family name (e.g., 'Inter', 'Anton', 'Space Grotesk', 'Bebas Neue').","type":"string"},"fontWeight":{"description":"Font weight (e.g., '400', '600', '700', '800').","type":"string"},"textAlign":{"description":"Text alignment.","type":"string","enum":["left","center","right","justify"]},"lineHeight":{"description":"Line height multiplier (0.8-2).","type":"number","minimum":0.8,"maximum":2},"letterSpacing":{"description":"Letter spacing in pixels.","type":"number","minimum":-2,"maximum":10},"color":{"description":"Text color as hex (e.g., '#FFFFFF') or rgba.","type":"string"},"backgroundColor":{"description":"Background color as hex or rgba. Use 'transparent' for no background.","type":"string"},"borderRadius":{"description":"Border radius for background in pixels.","type":"integer","minimum":0,"maximum":50},"textStrokeEnabled":{"description":"Enable text outline.","type":"boolean"},"textStrokeColor":{"description":"Outline color as hex (e.g., '#000000').","type":"string"},"textStrokeWidthPx":{"description":"Outline width in pixels (0-10).","type":"integer","minimum":0,"maximum":10},"textStrokeBlurPx":{"description":"Outline blur in pixels.","type":"integer","minimum":0,"maximum":20},"textShadow":{"description":"CSS text-shadow value (e.g., '0 0 10px #00FFFF' for glow, '0 4px 16px rgba(0,0,0,0.5)' for drop shadow, 'none' to remove).","type":"string"},"position":{"description":"Vertical position preset.","type":"string","enum":["bottom","middle","top","custom"]},"customPositionY":{"description":"Custom Y position in output canvas pixels from top (0-2000).","type":"integer","minimum":0,"maximum":2000},"showActiveWord":{"description":"Highlight the currently spoken word.","type":"boolean"},"activeWordColor":{"description":"Color of the active/highlighted word.","type":"string"},"activeWordBackgroundColor":{"description":"Background color of the active word.","type":"string"},"activeWordAnimation":{"description":"Animation style for active word.","type":"string","enum":["highlight","scale","glow","lift","bounce","punch","slam","elastic","shake","none"]},"emojiOverlaySizePx":{"description":"Top-overlay emoji size in pixels. Use 0 to disable, otherwise 64-220.","anyOf":[{"anyOf":[{"type":"number","const":0},{"type":"integer","minimum":64,"maximum":220}]},{"type":"null"}]},"wordRevealAnimation":{"description":"Animation when words appear.","type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},"maxLinesPerCaption":{"description":"Maximum lines per caption (1-4).","type":"integer","minimum":1,"maximum":4},"wordsPerLineLimit":{"description":"Max words per line. Null for auto.","anyOf":[{"type":"integer","minimum":1,"maximum":10},{"type":"null"}]},"emphasisEnabled":{"description":"Enable emphasis styling for important words.","type":"boolean"},"emphasisColor":{"description":"Emphasis text color.","anyOf":[{"type":"string"},{"type":"null"}]},"emphasisScale":{"description":"Scale factor for emphasis words (1-2).","type":"number","minimum":1,"maximum":2},"emphasisFontWeight":{"description":"Font weight for emphasis words.","type":"string"},"emphasisGlowColor":{"description":"Glow color for emphasis words.","anyOf":[{"type":"string"},{"type":"null"}]},"emphasisGlowBlurPx":{"description":"Glow blur for emphasis words.","anyOf":[{"type":"integer","minimum":0,"maximum":30},{"type":"null"}]}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updated_properties":{"type":"array","items":{"type":"string"}},"look_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"preset_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"boolean"},"effective_settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"warnings":{"default":[],"type":"array","items":{"type":"string"}},"cleared_word_overrides":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"message":{"type":"string"}},"required":["success","updated_properties","verified","effective_settings","warnings","cleared_word_overrides"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words":{"get":{"operationId":"getProjectsProjectIdCaptionsWords","summary":"List caption words","description":"List caption words.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"timeline_item_id","schema":{"type":"string"}},{"in":"query","name":"match_text","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":500}},{"in":"query","name":"offset","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"captionId":{"type":"string"},"timelineItemId":{"anyOf":[{"type":"string"},{"type":"null"}]},"word":{"type":"string"},"orderIndex":{"type":"number"},"sequenceIndex":{"type":"number"},"isEmphasis":{"type":"boolean"},"startUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"endUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"startSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"endSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"paragraphIndex":{"anyOf":[{"type":"number"},{"type":"null"}]},"style":{"anyOf":[{"type":"object","properties":{"offsetX":{"anyOf":[{"type":"number"},{"type":"null"}]},"offsetY":{"anyOf":[{"type":"number"},{"type":"null"}]},"rotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"anyOf":[{"type":"number"},{"type":"null"}]},"fontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"fontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeAnimation":{"anyOf":[{"type":"string","enum":["none","slide-from-bottom","pop","glow","punch"]},{"type":"null"}]},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textTransform":{"anyOf":[{"type":"string","enum":["none","uppercase"]},{"type":"null"}]},"letterSpacing":{"anyOf":[{"type":"number"},{"type":"null"}]},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundRadiusPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emojiName":{"anyOf":[{"type":"string"},{"type":"null"}]},"emojiScale":{"anyOf":[{"type":"string","enum":["1","2","0.5"]},{"type":"null"}]},"isSpecial":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isKeyword":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","captionId","timelineItemId","word","orderIndex","sequenceIndex","isEmphasis","startUnits","endUnits","startSeconds","endSeconds","paragraphIndex","style"],"additionalProperties":false}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"captionId":{"type":"string"},"timelineItemId":{"anyOf":[{"type":"string"},{"type":"null"}]},"word":{"type":"string"},"orderIndex":{"type":"number"},"sequenceIndex":{"type":"number"},"isEmphasis":{"type":"boolean"},"startUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"endUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"startSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"endSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"paragraphIndex":{"anyOf":[{"type":"number"},{"type":"null"}]},"style":{"anyOf":[{"type":"object","properties":{"offsetX":{"anyOf":[{"type":"number"},{"type":"null"}]},"offsetY":{"anyOf":[{"type":"number"},{"type":"null"}]},"rotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"anyOf":[{"type":"number"},{"type":"null"}]},"fontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"fontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeAnimation":{"anyOf":[{"type":"string","enum":["none","slide-from-bottom","pop","glow","punch"]},{"type":"null"}]},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textTransform":{"anyOf":[{"type":"string","enum":["none","uppercase"]},{"type":"null"}]},"letterSpacing":{"anyOf":[{"type":"number"},{"type":"null"}]},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundRadiusPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emojiName":{"anyOf":[{"type":"string"},{"type":"null"}]},"emojiScale":{"anyOf":[{"type":"string","enum":["1","2","0.5"]},{"type":"null"}]},"isSpecial":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isKeyword":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","captionId","timelineItemId","word","orderIndex","sequenceIndex","isEmphasis","startUnits","endUnits","startSeconds","endSeconds","paragraphIndex","style"],"additionalProperties":false}},"count":{"type":"number"},"warnings":{"default":[],"type":"array","items":{"type":"string"}},"pagination":{"type":"object","properties":{"total":{"type":"number"},"returned":{"type":"number"},"offset":{"type":"number"},"limit":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["total","returned","offset","limit","hasMore"],"additionalProperties":false},"summary":{"type":"object","properties":{"totalWords":{"type":"number"},"emphasisCount":{"type":"number"},"hasEmphasis":{"type":"boolean"}},"required":["totalWords","emphasisCount","hasEmphasis"],"additionalProperties":false},"hint":{"type":"string"}},"required":["success","words","items","count","warnings","pagination","summary"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/emphasis":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsEmphasis","summary":"Set caption word emphasis","description":"Set caption word emphasis.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word_ids":{"type":"array","items":{"type":"string"}},"match_text":{"type":"string"},"match_pattern":{"type":"string","enum":["numbers","caps","exclamations"]},"timeline_item_id":{"type":"string"},"all":{"type":"boolean"},"from_seconds":{"type":"number","minimum":0},"to_seconds":{"type":"number","minimum":0},"emphasis":{"type":"boolean"}},"required":["emphasis"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updated_count":{"type":"number"},"updated_word_ids":{"type":"array","items":{"type":"string"}},"emphasis":{"type":"boolean"},"message":{"type":"string"}},"required":["success","updated_count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/style":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsStyle","summary":"Update caption word styles","description":"Update caption word styles.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word_ids":{"type":"array","items":{"type":"string"}},"match_text":{"type":"string"},"match_pattern":{"type":"string","enum":["numbers","caps","exclamations"]},"timeline_item_id":{"type":"string"},"all":{"type":"boolean"},"from_seconds":{"type":"number","minimum":0},"to_seconds":{"type":"number","minimum":0},"style":{"anyOf":[{"type":"object","properties":{"offsetX":{"anyOf":[{"type":"number"},{"type":"null"}]},"offsetY":{"anyOf":[{"type":"number"},{"type":"null"}]},"rotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"anyOf":[{"type":"number"},{"type":"null"}]},"fontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"fontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeAnimation":{"anyOf":[{"type":"string","enum":["none","slide-from-bottom","pop","glow","punch"]},{"type":"null"}]},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textTransform":{"anyOf":[{"type":"string","enum":["none","uppercase"]},{"type":"null"}]},"letterSpacing":{"anyOf":[{"type":"number"},{"type":"null"}]},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundRadiusPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emojiName":{"anyOf":[{"type":"string"},{"type":"null"}]},"emojiScale":{"anyOf":[{"type":"string","enum":["1","2","0.5"]},{"type":"null"}]},"isSpecial":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isKeyword":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"clear_existing":{"type":"boolean"}},"required":["style"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updated_count":{"type":"number"},"updated_word_ids":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success","updated_count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/text":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsText","summary":"Update a caption word text","description":"Update a caption word text.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"new_text":{"type":"string","minLength":1}},"required":["word_id","new_text"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"word_id":{"type":"string"},"old_text":{"type":"string"},"new_text":{"type":"string"},"message":{"type":"string"}},"required":["success","word_id","old_text","new_text"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/batch-text":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsBatchText","summary":"Update multiple caption word texts","description":"Update multiple caption word texts.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"updates":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"word_id":{"type":"string"},"new_text":{"type":"string","minLength":1}},"required":["word_id","new_text"]}}},"required":["updates"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updates":{"type":"array","items":{"type":"object","properties":{"word_id":{"type":"string"},"caption_id":{"type":"string"},"old_text":{"type":"string"},"new_text":{"type":"string"}},"required":["word_id","caption_id","old_text","new_text"],"additionalProperties":false}},"affected_caption_ids":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success","updates","affected_caption_ids"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/retime":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsRetime","summary":"Update caption word timing","description":"Update caption word timing.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"updates":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"word_id":{"type":"string"},"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","minimum":0}},"required":["word_id","start_seconds","end_seconds"]}}},"required":["updates"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updates":{"type":"array","items":{"type":"object","properties":{"word_id":{"type":"string"},"caption_id":{"type":"string"},"old_start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"old_end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"new_start_units":{"type":"number"},"new_end_units":{"type":"number"},"old_start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"old_end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"new_start_seconds":{"type":"number"},"new_end_seconds":{"type":"number"}},"required":["word_id","caption_id","old_start_units","old_end_units","new_start_units","new_end_units","old_start_seconds","old_end_seconds","new_start_seconds","new_end_seconds"],"additionalProperties":false}},"affected_caption_ids":{"type":"array","items":{"type":"string"}},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","updates","affected_caption_ids","words","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/delete":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsDelete","summary":"Delete caption words","description":"Delete caption words.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word_ids":{"type":"array","items":{"type":"string"}},"timeline_item_id":{"type":"string"},"all":{"type":"boolean"},"from_seconds":{"type":"number","minimum":0},"to_seconds":{"type":"number","minimum":0}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"caption_id":{"type":"string"},"affected_caption_ids":{"type":"array","items":{"type":"string"}},"deleted_word_ids":{"type":"array","items":{"type":"string"}},"merged_word_id":{"type":"string"},"split_word_ids":{"type":"array","items":{"type":"string"}},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","caption_id","words","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/merge":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsMerge","summary":"Merge caption words","description":"Merge caption words.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word_ids":{"minItems":2,"type":"array","items":{"type":"string"}},"text":{"type":"string","minLength":1}},"required":["word_ids"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"caption_id":{"type":"string"},"affected_caption_ids":{"type":"array","items":{"type":"string"}},"deleted_word_ids":{"type":"array","items":{"type":"string"}},"merged_word_id":{"type":"string"},"split_word_ids":{"type":"array","items":{"type":"string"}},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","caption_id","words","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/words/split":{"post":{"operationId":"createProjectsProjectIdCaptionsWordsSplit","summary":"Split a caption word","description":"Split a caption word.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word_id":{"type":"string"},"words":{"minItems":2,"type":"array","items":{"type":"string","minLength":1}}},"required":["word_id","words"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"caption_id":{"type":"string"},"affected_caption_ids":{"type":"array","items":{"type":"string"}},"deleted_word_ids":{"type":"array","items":{"type":"string"}},"merged_word_id":{"type":"string"},"split_word_ids":{"type":"array","items":{"type":"string"}},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units"],"additionalProperties":false}},"message":{"type":"string"}},"required":["success","caption_id","words","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/captions/{captionId}":{"get":{"operationId":"getProjectsProjectIdCaptionsCaptionId","summary":"Get caption","description":"Get caption.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"captionId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"caption":{"type":"object","properties":{"caption_id":{"type":"string"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"project_id":{"type":"string"},"text":{"type":"string"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"paragraph_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_emphasis":{"type":"boolean"},"style":{"anyOf":[{"type":"object","properties":{"offsetX":{"anyOf":[{"type":"number"},{"type":"null"}]},"offsetY":{"anyOf":[{"type":"number"},{"type":"null"}]},"rotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"anyOf":[{"type":"number"},{"type":"null"}]},"fontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"fontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeAnimation":{"anyOf":[{"type":"string","enum":["none","slide-from-bottom","pop","glow","punch"]},{"type":"null"}]},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textTransform":{"anyOf":[{"type":"string","enum":["none","uppercase"]},{"type":"null"}]},"letterSpacing":{"anyOf":[{"type":"number"},{"type":"null"}]},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundRadiusPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emojiName":{"anyOf":[{"type":"string"},{"type":"null"}]},"emojiScale":{"anyOf":[{"type":"string","enum":["1","2","0.5"]},{"type":"null"}]},"isSpecial":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isKeyword":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units","start_seconds","end_seconds","paragraph_index","is_emphasis","style"],"additionalProperties":false}}},"required":["caption_id","timeline_item_id","project_id","text","start_units","end_units","start_seconds","end_seconds","words"],"additionalProperties":false}},"required":["success","caption"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateProjectsProjectIdCaptionsCaptionId","summary":"Patch caption text","description":"Patch caption text.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"captionId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1},"start_units":{"type":"integer","minimum":0,"maximum":9007199254740991},"end_units":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"caption":{"type":"object","properties":{"caption_id":{"type":"string"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"project_id":{"type":"string"},"text":{"type":"string"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"words":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"word":{"type":"string"},"order_index":{"type":"number"},"start_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_units":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"paragraph_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_emphasis":{"type":"boolean"},"style":{"anyOf":[{"type":"object","properties":{"offsetX":{"anyOf":[{"type":"number"},{"type":"null"}]},"offsetY":{"anyOf":[{"type":"number"},{"type":"null"}]},"rotationDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"anyOf":[{"type":"number"},{"type":"null"}]},"fontFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"fontWeight":{"anyOf":[{"type":"string"},{"type":"null"}]},"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeAnimation":{"anyOf":[{"type":"string","enum":["none","slide-from-bottom","pop","glow","punch"]},{"type":"null"}]},"fontStyle":{"anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"textTransform":{"anyOf":[{"type":"string","enum":["none","uppercase"]},{"type":"null"}]},"letterSpacing":{"anyOf":[{"type":"number"},{"type":"null"}]},"opacity":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeWidthPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textStrokeBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"glowBlurPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"textGradientFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"textGradientAngleDeg":{"anyOf":[{"type":"number"},{"type":"null"}]},"backgroundRadiusPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"emojiName":{"anyOf":[{"type":"string"},{"type":"null"}]},"emojiScale":{"anyOf":[{"type":"string","enum":["1","2","0.5"]},{"type":"null"}]},"isSpecial":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isKeyword":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","word","order_index","start_units","end_units","start_seconds","end_seconds","paragraph_index","is_emphasis","style"],"additionalProperties":false}}},"required":["caption_id","timeline_item_id","project_id","text","start_units","end_units","start_seconds","end_seconds","words"],"additionalProperties":false},"updated_words":{"type":"number"},"inserted_words":{"type":"number"},"deleted_words":{"type":"number"},"message":{"type":"string"}},"required":["success","caption","updated_words","inserted_words","deleted_words","message"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-themes":{"get":{"operationId":"listCaptionThemes","summary":"List caption themes","description":"List caption themes.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"themes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"settings":{},"is_public":{"type":"boolean"},"usage_count":{"type":"number"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_default":{"type":"boolean"}},"required":["id","name","description","settings","is_public","usage_count","created_at","updated_at","is_default"],"additionalProperties":false}},"total":{"type":"number"}},"required":["themes","total"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createCaptionTheme","summary":"Create caption theme","description":"Create caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string"},"settings":{"type":"object","properties":{"fontSize":{"type":"number"},"fontFamily":{"type":"string"},"fontWeight":{"type":"string"},"fontStyle":{"default":"normal","anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"color":{"type":"string"},"backgroundColor":{"type":"string"},"borderRadius":{"type":"number"},"textAlign":{"type":"string","enum":["left","center","right","justify"]},"activeWordColor":{"type":"string"},"activeWordBackgroundColor":{"type":"string"},"activeWordAnimation":{"type":"string","enum":["highlight","scale","glow","lift","bounce","punch","slam","elastic","shake","none"]},"emojiOverlaySizePx":{"anyOf":[{"anyOf":[{"type":"number","const":0},{"type":"number","minimum":64,"maximum":220}]},{"type":"null"}]},"showActiveWord":{"type":"boolean"},"maxLinesPerCaption":{"type":"number"},"lineHeight":{"type":"number"},"letterSpacing":{"type":"number"},"wordSpacingPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string","enum":["bottom","middle","top","custom"]},"customPositionY":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"type":"string"},"shadowMode":{"anyOf":[{"type":"string","enum":["text-shadow","drop-shadow"]},{"type":"null"}]},"border":{"type":"string"},"textFillStyle":{"type":"string","enum":["solid","gradient"]},"textGradientFrom":{"type":"string"},"textGradientTo":{"type":"string"},"textGradientAngleDeg":{"type":"number"},"textGradientStops":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeEnabled":{"type":"boolean"},"textStrokeColor":{"type":"string"},"textStrokeWidthPx":{"type":"number"},"textStrokeBlurPx":{"type":"number"},"wordRevealAnimation":{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},"wordsPerLineLimit":{"anyOf":[{"type":"number"},{"type":"null"}]},"activeWordHoldMs":{"type":"number"},"paragraphMode":{"type":"string","enum":["off","auto","manual"]},"paragraphTransition":{"type":"string","enum":["fade","slide-up"]},"paragraphFadeMs":{"type":"number"},"revealMode":{"type":"string","enum":["single","sequential","static"]},"paragraphReveal":{"type":"string","enum":["sequential","static"]},"pageCombineMs":{"type":"number"}}}},"required":["name","settings"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"settings":{},"is_public":{"type":"boolean"},"usage_count":{"type":"number"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","description","settings","is_public","usage_count","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-themes/{themeId}":{"get":{"operationId":"getCaptionTheme","summary":"Get caption theme","description":"Get caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"themeId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"settings":{},"is_public":{"type":"boolean"},"usage_count":{"type":"number"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_default":{"type":"boolean"}},"required":["id","name","description","settings","is_public","usage_count","created_at","updated_at","is_default"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateCaptionTheme","summary":"Update caption theme","description":"Update caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"themeId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string"},"settings":{"type":"object","properties":{"fontSize":{"type":"number"},"fontFamily":{"type":"string"},"fontWeight":{"type":"string"},"fontStyle":{"default":"normal","anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"color":{"type":"string"},"backgroundColor":{"type":"string"},"borderRadius":{"type":"number"},"textAlign":{"type":"string","enum":["left","center","right","justify"]},"activeWordColor":{"type":"string"},"activeWordBackgroundColor":{"type":"string"},"activeWordAnimation":{"type":"string","enum":["highlight","scale","glow","lift","bounce","punch","slam","elastic","shake","none"]},"emojiOverlaySizePx":{"anyOf":[{"anyOf":[{"type":"number","const":0},{"type":"number","minimum":64,"maximum":220}]},{"type":"null"}]},"showActiveWord":{"type":"boolean"},"maxLinesPerCaption":{"type":"number"},"lineHeight":{"type":"number"},"letterSpacing":{"type":"number"},"wordSpacingPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string","enum":["bottom","middle","top","custom"]},"customPositionY":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"type":"string"},"shadowMode":{"anyOf":[{"type":"string","enum":["text-shadow","drop-shadow"]},{"type":"null"}]},"border":{"type":"string"},"textFillStyle":{"type":"string","enum":["solid","gradient"]},"textGradientFrom":{"type":"string"},"textGradientTo":{"type":"string"},"textGradientAngleDeg":{"type":"number"},"textGradientStops":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeEnabled":{"type":"boolean"},"textStrokeColor":{"type":"string"},"textStrokeWidthPx":{"type":"number"},"textStrokeBlurPx":{"type":"number"},"wordRevealAnimation":{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},"wordsPerLineLimit":{"anyOf":[{"type":"number"},{"type":"null"}]},"activeWordHoldMs":{"type":"number"},"paragraphMode":{"type":"string","enum":["off","auto","manual"]},"paragraphTransition":{"type":"string","enum":["fade","slide-up"]},"paragraphFadeMs":{"type":"number"},"revealMode":{"type":"string","enum":["single","sequential","static"]},"paragraphReveal":{"type":"string","enum":["sequential","static"]},"pageCombineMs":{"type":"number"}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"settings":{},"is_public":{"type":"boolean"},"usage_count":{"type":"number"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","description","settings","is_public","usage_count","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteCaptionTheme","summary":"Delete caption theme","description":"Delete caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"themeId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-themes/{themeId}/duplicate":{"post":{"operationId":"duplicateCaptionTheme","summary":"Duplicate caption theme","description":"Duplicate caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"themeId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"settings":{},"is_public":{"type":"boolean"},"usage_count":{"type":"number"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","description","settings","is_public","usage_count","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-themes/{themeId}/set-default":{"post":{"operationId":"setDefaultCaptionTheme","summary":"Set workspace default caption theme","description":"Set workspace default caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"themeId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"scope":{"type":"string","const":"workspace"},"workspace_id":{"type":"string"},"default_caption_theme_id":{"type":"string"}},"required":["success","scope","workspace_id","default_caption_theme_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/caption-theme":{"post":{"operationId":"setProjectCaptionTheme","summary":"Set project caption theme","description":"Set project caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"theme_id":{"type":"string"}},"required":["theme_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"theme_id":{"type":"string"}},"required":["success","theme_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/caption-themes/preview":{"post":{"operationId":"previewCaptionTheme","summary":"Preview caption theme","description":"Preview caption theme.","tags":["Captions and Themes"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","properties":{"fontSize":{"type":"number"},"fontFamily":{"type":"string"},"fontWeight":{"type":"string"},"fontStyle":{"default":"normal","anyOf":[{"type":"string","enum":["normal","italic"]},{"type":"null"}]},"color":{"type":"string"},"backgroundColor":{"type":"string"},"borderRadius":{"type":"number"},"textAlign":{"type":"string","enum":["left","center","right","justify"]},"activeWordColor":{"type":"string"},"activeWordBackgroundColor":{"type":"string"},"activeWordAnimation":{"type":"string","enum":["highlight","scale","glow","lift","bounce","punch","slam","elastic","shake","none"]},"emojiOverlaySizePx":{"anyOf":[{"anyOf":[{"type":"number","const":0},{"type":"number","minimum":64,"maximum":220}]},{"type":"null"}]},"showActiveWord":{"type":"boolean"},"maxLinesPerCaption":{"type":"number"},"lineHeight":{"type":"number"},"letterSpacing":{"type":"number"},"wordSpacingPx":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string","enum":["bottom","middle","top","custom"]},"customPositionY":{"anyOf":[{"type":"number"},{"type":"null"}]},"textShadow":{"type":"string"},"shadowMode":{"anyOf":[{"type":"string","enum":["text-shadow","drop-shadow"]},{"type":"null"}]},"border":{"type":"string"},"textFillStyle":{"type":"string","enum":["solid","gradient"]},"textGradientFrom":{"type":"string"},"textGradientTo":{"type":"string"},"textGradientAngleDeg":{"type":"number"},"textGradientStops":{"anyOf":[{"type":"string"},{"type":"null"}]},"textStrokeEnabled":{"type":"boolean"},"textStrokeColor":{"type":"string"},"textStrokeWidthPx":{"type":"number"},"textStrokeBlurPx":{"type":"number"},"wordRevealAnimation":{"type":"string","enum":["none","fade","scale","slide-up","slide-left","slide-mix","pop","drop","slam","typewriter","glitch","mask-reveal","bounce-up","split-reveal"]},"wordsPerLineLimit":{"anyOf":[{"type":"number"},{"type":"null"}]},"activeWordHoldMs":{"type":"number"},"paragraphMode":{"type":"string","enum":["off","auto","manual"]},"paragraphTransition":{"type":"string","enum":["fade","slide-up"]},"paragraphFadeMs":{"type":"number"},"revealMode":{"type":"string","enum":["single","sequential","static"]},"paragraphReveal":{"type":"string","enum":["sequential","static"]},"pageCombineMs":{"type":"number"}}},"sample_text":{"type":"string"},"aspect_ratio":{"type":"string","enum":["9:16","16:9","1:1"]},"target_width":{"type":"number","minimum":100,"maximum":3840},"image_format":{"type":"string","enum":["png","jpeg"]}},"required":["settings"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"preview_url":{"type":"string"},"expires_at":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"}},"required":["preview_url","expires_at","width","height"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/styles":{"get":{"operationId":"getAiEditStyles","summary":"List AI edit styles","description":"List AI edit styles.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["mirage-black","clean-founder","formation-clipperz"]},"name":{"type":"string"},"description":{"type":"string"},"preview_image_path":{"type":"string"},"manual_skill":{"type":"object","properties":{"type":{"type":"string","const":"local_skill"},"path":{"type":"string"},"style_json_path":{"type":"string"}},"required":["type","path","style_json_path"],"additionalProperties":false},"spec":{"type":"object","properties":{},"additionalProperties":{}}},"required":["id","name","description","preview_image_path","manual_skill","spec"],"additionalProperties":false}},"total":{"type":"number"}},"required":["styles","total"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/ai-edit/runs":{"post":{"operationId":"createProjectsProjectIdAiEditRuns","summary":"Create external AI edit run","description":"Create external AI edit run.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"style_id":{"type":"string","enum":["mirage-black","clean-founder","formation-clipperz"]},"quality_target":{"default":"fast","type":"string","enum":["fast","premium","frontier"]},"controller_kind":{"default":"api","type":"string","enum":["api","cli","codex","claude_code","platform","unknown"]},"dry_run":{"default":false,"type":"boolean"}},"required":["style_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string"},"project_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"execution_mode":{"type":"string","enum":["external_controller","hosted_agent"]},"credit_mode":{"type":"string","enum":["external","platform_credits","byok"]},"controller_kind":{"type":"string","enum":["api","cli","codex","claude_code","platform","unknown"]},"status":{"type":"string","enum":["queued","understanding","planning","applying","rendering","critiquing","repairing","completed","failed","needs_review"]},"style_id":{"type":"string","enum":["mirage-black","clean-founder","formation-clipperz"]},"quality_target":{"type":"string","enum":["fast","premium","frontier"]},"run_config":{"type":"object","properties":{},"additionalProperties":{}},"budget_receipt":{"type":"object","properties":{},"additionalProperties":{}},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"failure_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","organization_id","user_id","api_key_id","execution_mode","credit_mode","controller_kind","status","style_id","quality_target","run_config","budget_receipt","summary","failure_message","completed_at","created_at","updated_at"],"additionalProperties":false},"context":{"type":"object","properties":{},"additionalProperties":{}}},"required":["run","context"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/runs/{runId}":{"get":{"operationId":"getAiEditRunsRunId","summary":"Get AI edit run","description":"Get AI edit run.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string"},"project_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"execution_mode":{"type":"string","enum":["external_controller","hosted_agent"]},"credit_mode":{"type":"string","enum":["external","platform_credits","byok"]},"controller_kind":{"type":"string","enum":["api","cli","codex","claude_code","platform","unknown"]},"status":{"type":"string","enum":["queued","understanding","planning","applying","rendering","critiquing","repairing","completed","failed","needs_review"]},"style_id":{"type":"string","enum":["mirage-black","clean-founder","formation-clipperz"]},"quality_target":{"type":"string","enum":["fast","premium","frontier"]},"run_config":{"type":"object","properties":{},"additionalProperties":{}},"budget_receipt":{"type":"object","properties":{},"additionalProperties":{}},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"failure_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","organization_id","user_id","api_key_id","execution_mode","credit_mode","controller_kind","status","style_id","quality_target","run_config","budget_receipt","summary","failure_message","completed_at","created_at","updated_at"],"additionalProperties":false},"context":{"type":"object","properties":{},"additionalProperties":{}}},"required":["run","context"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/runs/{runId}/logs":{"get":{"operationId":"getAiEditRunsRunIdLogs","summary":"List AI edit run logs","description":"List AI edit run logs.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":100,"type":"integer","exclusiveMinimum":0,"maximum":500}},{"in":"query","name":"offset","schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string"},"project_id":{"type":"string"},"logs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"run_id":{"type":"string"},"organization_id":{"type":"string"},"project_id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"input":{"type":"object","properties":{},"additionalProperties":{}},"output":{"type":"object","properties":{},"additionalProperties":{}},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","run_id","organization_id","project_id","kind","status","input","output","error_message","created_at"],"additionalProperties":false}},"artifacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"run_id":{"type":"string"},"organization_id":{"type":"string"},"project_id":{"type":"string"},"artifact_type":{"type":"string"},"time_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"storage_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","properties":{},"additionalProperties":{}},"created_at":{"type":"string"}},"required":["id","run_id","organization_id","project_id","artifact_type","time_seconds","url","storage_key","metadata","created_at"],"additionalProperties":false}},"bounds":{"type":"object","properties":{"logs":{"type":"object","properties":{"offset":{"type":"number"},"limit":{"type":"number"},"returned":{"type":"number"},"truncated":{"type":"boolean"}},"required":["offset","limit","returned","truncated"],"additionalProperties":false}},"required":["logs"],"additionalProperties":false}},"required":["run_id","project_id","logs","artifacts","bounds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createAiEditRunsRunIdLogs","summary":"Append AI edit run log","description":"Append AI edit run log.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","minLength":1,"maxLength":80},"status":{"default":"completed","type":"string","enum":["queued","running","completed","failed","skipped"]},"message":{"default":"","type":"string","maxLength":2000},"metadata":{"default":{},"type":"object","properties":{},"additionalProperties":{}},"dry_run":{"default":false,"type":"boolean"}},"required":["kind"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"dry_run":{"type":"boolean"},"run_id":{"type":"string"},"log":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"run_id":{"type":"string"},"organization_id":{"type":"string"},"project_id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"input":{"type":"object","properties":{},"additionalProperties":{}},"output":{"type":"object","properties":{},"additionalProperties":{}},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","run_id","organization_id","project_id","kind","status","input","output","error_message","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["success","dry_run","run_id","log"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/runs/{runId}/apply-style":{"post":{"operationId":"createAiEditRunsRunIdApplyStyle","summary":"Apply AI edit style","description":"Apply AI edit style.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"default":false,"type":"boolean"},"title_text":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"title_card_theme":{"default":null,"anyOf":[{"type":"string","enum":["classic_white","white_black_outline","stacked_black_white","red_on_black","black_on_yellow","red_block"]},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"dry_run":{"type":"boolean"},"run_id":{"type":"string"},"project_id":{"type":"string"},"style_id":{"type":"string","enum":["mirage-black","clean-founder","formation-clipperz"]},"receipts":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"target_id":{"type":"string"},"dry_run":{"type":"boolean"},"changes":{"type":"object","properties":{},"additionalProperties":{}}},"required":["action","target_id","dry_run","changes"],"additionalProperties":false}},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","dry_run","run_id","project_id","style_id","receipts","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/runs/{runId}/snapshots":{"post":{"operationId":"createAiEditRunsRunIdSnapshots","summary":"Render AI edit snapshots","description":"Render AI edit snapshots.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"default":false,"type":"boolean"},"times":{"default":["hook","middle","end"],"type":"array","items":{"anyOf":[{"type":"number"},{"type":"string","enum":["start","hook","middle","end"]}]}},"target_width":{"default":608,"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"image_format":{"default":"jpeg","type":"string","enum":["jpeg","png"]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"dry_run":{"type":"boolean"},"run_id":{"type":"string"},"project_id":{"type":"string"},"snapshots":{"type":"array","items":{"type":"object","properties":{"artifact_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"storage_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame":{"anyOf":[{"type":"number"},{"type":"null"}]},"time_seconds":{"type":"number"},"width":{"anyOf":[{"type":"number"},{"type":"null"}]},"height":{"anyOf":[{"type":"number"},{"type":"null"}]},"image_format":{"type":"string","enum":["jpeg","png"]}},"required":["artifact_id","preview_url","storage_key","frame","time_seconds","width","height","image_format"],"additionalProperties":false}}},"required":["success","dry_run","run_id","project_id","snapshots"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/runs/{runId}/validate":{"post":{"operationId":"createAiEditRunsRunIdValidate","summary":"Validate AI edit style","description":"Validate AI edit style.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"dry_run":{"type":"boolean"},"run_id":{"type":"string"},"project_id":{"type":"string"},"passed":{"type":"boolean"},"checks":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"passed":{"type":"boolean"},"message":{"type":"string"}},"required":["rule","passed","message"],"additionalProperties":false}}},"required":["success","dry_run","run_id","project_id","passed","checks"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/ai-edit/runs/{runId}/complete":{"post":{"operationId":"createAiEditRunsRunIdComplete","summary":"Complete AI edit run","description":"Complete AI edit run.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["completed","needs_review","failed"]},"summary":{"default":"","type":"string"},"dry_run":{"default":false,"type":"boolean"}},"required":["status"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"dry_run":{"type":"boolean"},"run_id":{"type":"string"},"status":{"type":"string","enum":["completed","needs_review","failed"]},"summary":{"type":"string"}},"required":["success","dry_run","run_id","status","summary"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/onboarding/brand-scan":{"post":{"operationId":"startOnboardingBrandScan","summary":"Start onboarding brand scan","description":"Start onboarding brand scan.","tags":["Onboarding"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"website_url":{"type":"string","minLength":1,"maxLength":2048},"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]}},"required":["website_url","business_outcome"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string"},"brand_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"type":"string"},"status":{"type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"pages_scanned":{"type":"number"},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"profile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"anyOf":[{"type":"string"},{"type":"null"}]},"messaging":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"color_palette":{"type":"array","items":{"type":"string"}},"logo_candidates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"],"additionalProperties":false}},"suggested_safe_words":{"type":"array","items":{"type":"string"}},"social_profiles":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"],"additionalProperties":false}},"status":{"type":"string"},"last_scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"type":"string"}},"required":["id","business_outcome","website_url","brand_name","tagline","audience","offer","conversion_goal","tone","messaging","color_palette","logo_candidates","suggested_safe_words","social_profiles","status","last_scanned_at","updated_at"],"additionalProperties":false},{"type":"null"}]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["run_id","brand_profile_id","source_url","status","error","pages_scanned","created_at","completed_at","profile","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/onboarding/brand-scans/{runId}":{"get":{"operationId":"getOnboardingBrandScan","summary":"Get onboarding brand scan","description":"Get onboarding brand scan.","tags":["Onboarding"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"runId","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string"},"brand_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"type":"string"},"status":{"type":"string"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"pages_scanned":{"type":"number"},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"profile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"anyOf":[{"type":"string"},{"type":"null"}]},"messaging":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"color_palette":{"type":"array","items":{"type":"string"}},"logo_candidates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"],"additionalProperties":false}},"suggested_safe_words":{"type":"array","items":{"type":"string"}},"social_profiles":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"],"additionalProperties":false}},"status":{"type":"string"},"last_scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"type":"string"}},"required":["id","business_outcome","website_url","brand_name","tagline","audience","offer","conversion_goal","tone","messaging","color_palette","logo_candidates","suggested_safe_words","social_profiles","status","last_scanned_at","updated_at"],"additionalProperties":false},{"type":"null"}]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["run_id","brand_profile_id","source_url","status","error","pages_scanned","created_at","completed_at","profile","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/onboarding/brand-profile":{"get":{"operationId":"getOnboardingBrandProfile","summary":"Get onboarding brand profile","description":"Get onboarding brand profile.","tags":["Onboarding"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"anyOf":[{"type":"string"},{"type":"null"}]},"messaging":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"color_palette":{"type":"array","items":{"type":"string"}},"logo_candidates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"],"additionalProperties":false}},"suggested_safe_words":{"type":"array","items":{"type":"string"}},"social_profiles":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"],"additionalProperties":false}},"status":{"type":"string"},"last_scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"type":"string"}},"required":["id","business_outcome","website_url","brand_name","tagline","audience","offer","conversion_goal","tone","messaging","color_palette","logo_candidates","suggested_safe_words","social_profiles","status","last_scanned_at","updated_at"],"additionalProperties":false},{"type":"null"}]},"onboarding":{"type":"object","properties":{"completed":{"type":"boolean"},"data_saved":{"type":"boolean"}},"required":["completed","data_saved"],"additionalProperties":false},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["profile","onboarding","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateOnboardingBrandProfile","summary":"Update onboarding brand profile","description":"Update onboarding brand profile.","tags":["Onboarding"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]},"social_profiles":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"]}},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}]},"audience":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"offer":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"tone":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}]},"color_palette":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":32}},{"type":"null"}]},"logo_candidates":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"]}},{"type":"null"}]},"suggested_safe_words":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":100}},{"type":"null"}]},"workspace_description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]}},"required":["business_outcome","website_url","social_profiles","brand_name","tagline","audience","offer","conversion_goal","tone","color_palette","logo_candidates","suggested_safe_words","workspace_description"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"anyOf":[{"type":"string"},{"type":"null"}]},"messaging":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"color_palette":{"type":"array","items":{"type":"string"}},"logo_candidates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"],"additionalProperties":false}},"suggested_safe_words":{"type":"array","items":{"type":"string"}},"social_profiles":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"],"additionalProperties":false}},"status":{"type":"string"},"last_scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"type":"string"}},"required":["id","business_outcome","website_url","brand_name","tagline","audience","offer","conversion_goal","tone","messaging","color_palette","logo_candidates","suggested_safe_words","social_profiles","status","last_scanned_at","updated_at"],"additionalProperties":false},{"type":"null"}]},"onboarding":{"type":"object","properties":{"completed":{"type":"boolean"},"data_saved":{"type":"boolean"}},"required":["completed","data_saved"],"additionalProperties":false},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["profile","onboarding","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/onboarding/logo/import":{"post":{"operationId":"importOnboardingLogo","summary":"Import onboarding logo","description":"Import onboarding logo.","tags":["Onboarding"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"logo_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]},"replace_existing":{"type":"boolean"}},"required":["profile_id","logo_url","replace_existing"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"icon_storage_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["success","icon_storage_key","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/onboarding/complete":{"post":{"operationId":"completeOnboarding","summary":"Complete onboarding","description":"Complete onboarding.","tags":["Onboarding"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]},"social_profiles":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"]}},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}]},"audience":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"offer":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"tone":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}]},"color_palette":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":32}},{"type":"null"}]},"logo_candidates":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"]}},{"type":"null"}]},"suggested_safe_words":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":100}},{"type":"null"}]},"workspace_description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"platforms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"save_workspace_icon":{"type":"boolean"}},"required":["business_outcome","website_url","social_profiles","brand_name","tagline","audience","offer","conversion_goal","tone","color_palette","logo_candidates","suggested_safe_words","workspace_description","platforms","save_workspace_icon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"workspace_config":{},"perk_granted":{"type":"boolean"},"profile":{"type":"object","properties":{"id":{"type":"string"},"business_outcome":{"anyOf":[{"type":"string","enum":["book_calls","sell_offer","grow_authority","repurpose_content","other"]},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"offer":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversion_goal":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"anyOf":[{"type":"string"},{"type":"null"}]},"messaging":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"color_palette":{"type":"array","items":{"type":"string"}},"logo_candidates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"label":{"anyOf":[{"type":"string","enum":["ogImage","og:image","twitterImage","logo image","image","icon","apple-touch-icon","favicon"]},{"type":"null"}]}},"required":["url","label"],"additionalProperties":false}},"suggested_safe_words":{"type":"array","items":{"type":"string"}},"social_profiles":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","youtube","instagram","tiktok","facebook","x"]},"value":{"type":"string","minLength":1,"maxLength":2048}},"required":["platform","value"],"additionalProperties":false}},"status":{"type":"string"},"last_scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"type":"string"}},"required":["id","business_outcome","website_url","brand_name","tagline","audience","offer","conversion_goal","tone","messaging","color_palette","logo_candidates","suggested_safe_words","social_profiles","status","last_scanned_at","updated_at"],"additionalProperties":false},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["success","workspace_config","perk_granted","profile","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/content-items":{"get":{"operationId":"listProjectContentItems","summary":"List editable content items","description":"List editable content items.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"content_item_id":{"type":"string"},"kind":{"type":"string","enum":["overlay","title_card","watermark"]},"name":{"type":"string"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"layer_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"playground_composition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"watermark_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"spec":{"anyOf":[{"type":"object","properties":{},"additionalProperties":{}},{"type":"null"}]},"watermark":{"anyOf":[{"type":"object","properties":{"style":{"type":"string","enum":["lower_third","corner_badge","intro_badge","safezone","floating"]},"text_preset":{"type":"string","enum":["blitzreels","edited_with","video_edited_with","video_edited_with_fr","content_copilot","short_edited_with","generated_with","made_with","powered_by"]},"opacity":{"type":"number"},"is_system":{"type":"boolean"}},"required":["style","text_preset","opacity","is_system"],"additionalProperties":false},{"type":"null"}]}},"required":["content_item_id","kind","name","timeline_item_id","start_seconds","duration_seconds","layer_index","playground_composition_id","watermark_id","spec","watermark"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createProjectContentItem","summary":"Create editable content item","description":"Create editable content item.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["overlay","title_card","watermark"]},"name":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"spec":{"type":"object","properties":{},"additionalProperties":{}},"watermark_style":{"type":"string","enum":["lower_third","corner_badge","intro_badge","safezone","floating"]},"watermark_text_preset":{"type":"string","enum":["blitzreels","edited_with","video_edited_with","video_edited_with_fr","content_copilot","short_edited_with","generated_with","made_with","powered_by"]},"start_seconds":{"type":"number","minimum":0},"duration_seconds":{"type":"number","minimum":0.1},"layer_index":{"type":"integer","minimum":0,"maximum":20}},"required":["kind"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"content_item_id":{"type":"string"},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"playground_composition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"watermark_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["success","content_item_id","timeline_item_id","playground_composition_id","watermark_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/content-items/{contentItemId}":{"patch":{"operationId":"updateProjectContentItem","summary":"Update editable content item","description":"Update editable content item.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"contentItemId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"spec":{"type":"object","properties":{},"additionalProperties":{}},"watermark_style":{"type":"string","enum":["lower_third","corner_badge","intro_badge","safezone","floating"]},"watermark_text_preset":{"type":"string","enum":["blitzreels","edited_with","video_edited_with","video_edited_with_fr","content_copilot","short_edited_with","generated_with","made_with","powered_by"]},"opacity":{"type":"number","minimum":0,"maximum":1},"duration_seconds":{"type":"number","exclusiveMinimum":0}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"content_item_id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["overlay","title_card","watermark"]},{"type":"null"}]},"timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"playground_composition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"watermark_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_text_count":{"type":"number"},"previous_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_text":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["success","content_item_id","kind","timeline_item_id","playground_composition_id","watermark_id","updated_text_count","previous_text","next_text"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteProjectContentItem","summary":"Delete editable content item","description":"Delete editable content item.","tags":["Timeline Editing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"contentItemId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace":{"get":{"operationId":"getWorkspace","summary":"Get workspace info","description":"Get workspace info.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"plan":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"memberCount":{"type":"number"},"defaults":{"type":"object","properties":{"aspectRatio":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}]},"frameRate":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoManageBroll":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["aspectRatio","resolution","frameRate","autoManageBroll"],"additionalProperties":false},"createdAt":{"type":"string"}},"required":["id","name","slug","plan","description","memberCount","defaults","createdAt"],"additionalProperties":false}},"required":["workspace"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/settings":{"get":{"operationId":"getWorkspaceSettings","summary":"Get workspace settings","description":"Get workspace settings.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeWords":{"type":"array","items":{"type":"string"}},"protected_words":{"type":"array","items":{"type":"string"}},"icon_storage_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaults":{"type":"object","properties":{"aspectRatio":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}]},"orientation":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}]},"frameRate":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame_rate":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoManageBroll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"auto_manage_broll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"captionThemeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption_theme_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["aspectRatio","aspect_ratio","orientation","resolution","frameRate","frame_rate","autoManageBroll","auto_manage_broll","captionThemeId","caption_theme_id"],"additionalProperties":false},"updated_at":{"type":"string"}},"required":["id","name","description","safeWords","protected_words","icon_storage_key","icon_url","defaults","updated_at"],"additionalProperties":false}},"required":["settings"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"updateWorkspaceSettings","summary":"Update workspace settings","description":"Update workspace settings.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":128},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"protected_words":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"safe_words":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"icon_storage_key":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"defaults":{"type":"object","properties":{"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:5"]},{"type":"null"}]},"orientation":{"anyOf":[{"type":"string","enum":["landscape","portrait","square"]},{"type":"null"}]},"resolution":{"anyOf":[{"type":"string","enum":["1","2","0.25","0.5","0.75","1.5"]},{"type":"null"}]},"frame_rate":{"anyOf":[{"type":"string","enum":["24","25","30","50","60","23.976","29.97","59.94"]},{"type":"null"}]},"auto_manage_broll":{"type":"boolean"},"caption_theme_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeWords":{"type":"array","items":{"type":"string"}},"protected_words":{"type":"array","items":{"type":"string"}},"icon_storage_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaults":{"type":"object","properties":{"aspectRatio":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}]},"orientation":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}]},"frameRate":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame_rate":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoManageBroll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"auto_manage_broll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"captionThemeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption_theme_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["aspectRatio","aspect_ratio","orientation","resolution","frameRate","frame_rate","autoManageBroll","auto_manage_broll","captionThemeId","caption_theme_id"],"additionalProperties":false},"updated_at":{"type":"string"}},"required":["id","name","description","safeWords","protected_words","icon_storage_key","icon_url","defaults","updated_at"],"additionalProperties":false},"success":{"type":"boolean","const":true}},"required":["settings","success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/icon/upload/init":{"post":{"operationId":"createWorkspaceIconUploadInit","summary":"Initialize a workspace icon upload","description":"Initialize a workspace icon upload.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"file_name":{"type":"string","minLength":1,"maxLength":200},"content_type":{"type":"string","minLength":1,"maxLength":120}},"required":["file_name","content_type"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"upload_url":{"type":"string"},"icon_storage_key":{"type":"string"},"icon_url":{"type":"string"},"expires_in":{"type":"number"},"instructions":{"type":"string"}},"required":["upload_url","icon_storage_key","icon_url","expires_in","instructions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/icon":{"delete":{"operationId":"deleteWorkspaceIcon","summary":"Delete workspace icon","description":"Delete workspace icon.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeWords":{"type":"array","items":{"type":"string"}},"protected_words":{"type":"array","items":{"type":"string"}},"icon_storage_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaults":{"type":"object","properties":{"aspectRatio":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}]},"orientation":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}]},"frameRate":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame_rate":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoManageBroll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"auto_manage_broll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"captionThemeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption_theme_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["aspectRatio","aspect_ratio","orientation","resolution","frameRate","frame_rate","autoManageBroll","auto_manage_broll","captionThemeId","caption_theme_id"],"additionalProperties":false},"updated_at":{"type":"string"}},"required":["id","name","description","safeWords","protected_words","icon_storage_key","icon_url","defaults","updated_at"],"additionalProperties":false},"success":{"type":"boolean","const":true}},"required":["settings","success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/credits":{"get":{"operationId":"getWorkspaceCredits","summary":"Get workspace AI credits","description":"Get workspace AI credits.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"credits":{"type":"object","properties":{"maxCredits":{"type":"number"},"usedCredits":{"type":"number"},"remainingCredits":{"type":"number"},"usagePercent":{"type":"number"},"billingPeriodStart":{"type":"string"}},"required":["maxCredits","usedCredits","remainingCredits","usagePercent","billingPeriodStart"],"additionalProperties":false}},"required":["credits"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/storage":{"get":{"operationId":"getWorkspaceStorage","summary":"Get workspace storage usage","description":"Get workspace storage usage.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"storage":{"type":"object","properties":{"totalBytes":{"type":"number"},"totalMB":{"type":"number"},"assetCount":{"type":"number"}},"required":["totalBytes","totalMB","assetCount"],"additionalProperties":false}},"required":["storage"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/members":{"get":{"operationId":"getWorkspaceMembers","summary":"List workspace members","description":"List workspace members.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string"},"joinedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["userId","email","displayName","role","joinedAt"],"additionalProperties":false}},"count":{"type":"number"}},"required":["members","count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/folders":{"get":{"operationId":"getWorkspaceMediaFolders","summary":"List media folders","description":"List media folders.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"parent_folder_id","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"folders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"parentFolderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconType":{"anyOf":[{"type":"string"},{"type":"null"}]},"assetCount":{"type":"number"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","parentFolderId","description","iconType","assetCount","createdAt"],"additionalProperties":false}},"count":{"type":"number"}},"required":["folders","count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createWorkspaceMediaFolders","summary":"Create a media folder","description":"Create a media folder.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"parent_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"icon_type":{"type":"string","enum":["folder","code","video","audio","image","document","star","spark"]}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"folder":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"parentFolderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconType":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","parentFolderId"],"additionalProperties":false}},"required":["success","folder"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets":{"get":{"operationId":"getWorkspaceMediaAssets","summary":"List media library assets","description":"List media library assets.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"query","name":"folder_id","schema":{"type":"string"}},{"in":"query","name":"asset_type","schema":{"type":"string","enum":["video","audio","image","document","all"]}},{"in":"query","name":"search","schema":{"type":"string"}},{"in":"query","name":"min_duration_seconds","schema":{"type":"number","minimum":0}},{"in":"query","name":"orientation","schema":{"type":"string","enum":["landscape","portrait","square"]}},{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":100}},{"in":"query","name":"offset","schema":{"type":"number","minimum":0}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"include_total","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"assetType":{"type":"string"},"folderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiTags":{"type":"array","items":{"type":"string"}},"aiMood":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiCameraMovement":{"anyOf":[{"type":"string"},{"type":"null"}]},"importSource":{"type":"string"},"fileSizeBytes":{"type":"number"},"allowUsingAsBroll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"processingStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"audioType":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"dimensionsWidth":{"anyOf":[{"type":"number"},{"type":"null"}]},"dimensionsHeight":{"anyOf":[{"type":"number"},{"type":"null"}]},"orientation":{"anyOf":[{"type":"string","enum":["landscape","portrait","square"]},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","assetType","folderId","thumbnailUrl","description","aiDescription","aiTags","aiMood","aiCameraMovement","importSource","fileSizeBytes","allowUsingAsBroll","processingStatus","audioType","durationSeconds","dimensionsWidth","dimensionsHeight","orientation","createdAt"],"additionalProperties":false}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"assetType":{"type":"string"},"folderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiTags":{"type":"array","items":{"type":"string"}},"aiMood":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiCameraMovement":{"anyOf":[{"type":"string"},{"type":"null"}]},"importSource":{"type":"string"},"fileSizeBytes":{"type":"number"},"allowUsingAsBroll":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"processingStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"audioType":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"dimensionsWidth":{"anyOf":[{"type":"number"},{"type":"null"}]},"dimensionsHeight":{"anyOf":[{"type":"number"},{"type":"null"}]},"orientation":{"anyOf":[{"type":"string","enum":["landscape","portrait","square"]},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","assetType","folderId","thumbnailUrl","description","aiDescription","aiTags","aiMood","aiCameraMovement","importSource","fileSizeBytes","allowUsingAsBroll","processingStatus","audioType","durationSeconds","dimensionsWidth","dimensionsHeight","orientation","createdAt"],"additionalProperties":false}},"count":{"type":"number"},"totalCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_count_exact":{"type":"boolean"},"limit":{"type":"number"},"offset":{"type":"number"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_more":{"type":"boolean"}},"required":["assets","items","count","totalCount","total_count_exact","limit","offset","next_cursor","has_more"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/folders/{folderId}":{"patch":{"operationId":"updateWorkspaceMediaFoldersFolderId","summary":"Update a media folder","description":"Update a media folder.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"folderId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"parent_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"icon_type":{"type":"string","enum":["folder","code","video","audio","image","document","star","spark"]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"folder":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"parentFolderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"iconType":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","parentFolderId"],"additionalProperties":false}},"required":["success","folder"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteWorkspaceMediaFoldersFolderId","summary":"Delete a media folder","description":"Delete a media folder.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"folderId","schema":{"type":"string"},"required":true},{"in":"query","name":"cascade","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}":{"patch":{"operationId":"updateWorkspaceMediaAssetsAssetId","summary":"Update a media asset","description":"Update a media asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"allow_using_as_broll":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"asset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"folderId":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowUsingAsBroll":{"type":"boolean"},"updatedAt":{"type":"string"}},"required":["id","name","description","folderId","allowUsingAsBroll","updatedAt"],"additionalProperties":false},"txid":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["success","asset","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"get":{"operationId":"getWorkspaceMediaAssetsAssetId","summary":"Get media asset details","description":"Get media asset details.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"assetType":{"type":"string","enum":["video","audio","image","document"]},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiTags":{"type":"array","items":{"type":"string"}},"aiMood":{"anyOf":[{"type":"string"},{"type":"null"}]},"aiCameraMovement":{"anyOf":[{"type":"string"},{"type":"null"}]},"audioType":{"anyOf":[{"type":"string"},{"type":"null"}]},"importSource":{"type":"string"},"waveformPeaks":{"type":"array","items":{"type":"number","minimum":0,"maximum":1}},"fileSizeBytes":{"type":"number"},"processingStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"processingSubstage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processingError":{"anyOf":[{"type":"string"},{"type":"null"}]},"processingErrors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processingAttempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"providerRequestIds":{"type":"object","properties":{"processJobRunId":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribeJobRunId":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerRequestId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["processJobRunId","transcribeJobRunId","providerRequestId"],"additionalProperties":false},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false},"durationSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"dimensionsWidth":{"anyOf":[{"type":"number"},{"type":"null"}]},"dimensionsHeight":{"anyOf":[{"type":"number"},{"type":"null"}]},"allowUsingAsBroll":{"type":"boolean"},"folderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordingSetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"recording_set_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","assetType","thumbnailUrl","fileUrl","description","aiDescription","aiTags","aiMood","aiCameraMovement","audioType","importSource","waveformPeaks","fileSizeBytes","processingSubstage","processingError","processingErrors","processingAttempts","retryable","providerRequestIds","processing_substage","processing_error","processing_errors","processing_attempts","provider_request_ids","durationSeconds","dimensionsWidth","dimensionsHeight","allowUsingAsBroll","folderName","recordingSetId","recording_set_id"],"additionalProperties":false}},"required":["asset"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/move":{"post":{"operationId":"createWorkspaceMediaAssetsMove","summary":"Move media assets to a folder","description":"Move media assets to a folder.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset_ids":{"minItems":1,"type":"array","items":{"type":"string"}},"target_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["asset_ids","target_folder_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"moved_count":{"type":"number"},"target_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["success","moved_count","target_folder_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/verify":{"get":{"operationId":"getWorkspaceMediaAssetsAssetIdVerify","summary":"Verify a media asset storage object","description":"Verify a media asset storage object.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"processing_status":{"type":"string"},"storage_provider":{"type":"string"},"storage_object":{"type":"string","enum":["present","missing","not_applicable","unverifiable"]},"ready_for_download":{"type":"boolean"}},"required":["asset_id","processing_status","storage_provider","storage_object","ready_for_download"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/transcript":{"get":{"operationId":"getWorkspaceMediaAssetsAssetIdTranscript","summary":"Get media asset transcript","description":"Get media asset transcript.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":200,"type":"integer","minimum":1,"maximum":500}},{"in":"query","name":"offset","schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string"},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"wordCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"lastGeneratedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"speakerLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["text","start","end","speakerLabel"],"additionalProperties":false}},"bounds":{"type":"object","properties":{"limit":{"type":"number"},"offset":{"type":"number"},"total":{"type":"number"},"returned":{"type":"number"},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["limit","offset","total","returned","hasMore","truncated"],"additionalProperties":false}},"required":["assetId","status","wordCount","lastGeneratedAt","text","segments","bounds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/delete":{"post":{"operationId":"createWorkspaceMediaAssetsAssetIdDelete","summary":"Delete a media asset","description":"Delete a media asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/clipping-status":{"get":{"operationId":"getWorkspaceMediaAssetsAssetIdClippingStatus","summary":"Get clipping readiness and canonical duration for an asset","description":"Get clipping readiness and canonical duration for an asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true},{"in":"query","name":"project_id","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"media_processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing":{"type":"object","properties":{"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_substage":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"processing_errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"processing_attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retryable":{"type":"boolean"},"provider_request_ids":{"type":"object","properties":{"process_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcribe_job_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_request_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["process_job_run_id","transcribe_job_run_id","provider_request_id"],"additionalProperties":false}},"required":["processing_status","processing_substage","processing_error","processing_errors","processing_attempts","retryable","provider_request_ids"],"additionalProperties":false},"transcript_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"transcript_word_count":{"type":"number"},"captions_status":{"type":"string","enum":["not_requested","missing","ready"]},"short_suggestions_status":{"type":"string","enum":["missing","ready","no_candidates"]},"suggestion_outcome":{"anyOf":[{"type":"object","properties":{"run_id":{"type":"string"},"suggestion_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"no_clip_reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["run_id","suggestion_count","no_clip_reason"],"additionalProperties":false},{"type":"null"}]},"suggestion_counts":{"type":"object","properties":{"drafts":{"type":"number"},"saved":{"type":"number"},"total":{"type":"number"}},"required":["drafts","saved","total"],"additionalProperties":false},"durations":{"type":"object","properties":{"asset_reported_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"transcript_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_suggestion_end_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"project_timeline_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"consistency":{"type":"string","enum":["consistent","inconsistent","unknown"]}},"required":["asset_reported_duration_seconds","transcript_duration_seconds","max_suggestion_end_seconds","project_timeline_duration_seconds","canonical_duration_seconds","consistency"],"additionalProperties":false},"readiness":{"type":"object","properties":{"transcript_ready":{"type":"boolean"},"suggestions_ready":{"type":"boolean"},"captions_ready":{"type":"boolean"},"ready_to_apply":{"type":"boolean"},"ready_to_export":{"type":"boolean"}},"required":["transcript_ready","suggestions_ready","captions_ready","ready_to_apply","ready_to_export"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["asset_id","project_id","media_processing_status","processing","transcript_status","transcript_word_count","captions_status","short_suggestions_status","suggestion_outcome","suggestion_counts","durations","readiness","warnings"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/upload/init":{"post":{"operationId":"createWorkspaceMediaUploadInit","summary":"Initialize a presigned media upload","description":"Initialize a presigned media upload.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"file_name":{"type":"string","minLength":1,"maxLength":200},"content_type":{"type":"string","minLength":1},"file_size_bytes":{"type":"number","exclusiveMinimum":0}},"required":["file_name","content_type"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"upload_url":{"type":"string"},"storage_key":{"type":"string"},"expires_in":{"type":"number"}},"required":["upload_url","storage_key","expires_in"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/upload/multipart/init":{"post":{"operationId":"createWorkspaceMediaUploadMultipartInit","summary":"Initialize a multipart media upload","description":"Initialize a multipart media upload.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"file_name":{"type":"string","minLength":1,"maxLength":200},"content_type":{"type":"string","minLength":1},"file_size_bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["file_name","content_type","file_size_bytes"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"storage_key":{"type":"string"},"upload_id":{"type":"string"},"part_size_bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["storage_key","upload_id","part_size_bytes"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/upload/multipart/parts":{"post":{"operationId":"createWorkspaceMediaUploadMultipartParts","summary":"Create multipart media upload part URLs","description":"Create multipart media upload part URLs.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storage_key":{"type":"string","minLength":1},"upload_id":{"type":"string","minLength":1},"part_numbers":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"integer","minimum":1,"maximum":10000}}},"required":["storage_key","upload_id","part_numbers"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"part_number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"upload_url":{"type":"string"}},"required":["part_number","upload_url"],"additionalProperties":false}}},"required":["parts"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/upload/multipart/complete":{"post":{"operationId":"createWorkspaceMediaUploadMultipartComplete","summary":"Complete a multipart media upload","description":"Complete a multipart media upload.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storage_key":{"type":"string","minLength":1},"upload_id":{"type":"string","minLength":1},"parts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etag":{"type":"string","minLength":1},"part_number":{"type":"integer","minimum":1,"maximum":10000}},"required":["etag","part_number"]}}},"required":["storage_key","upload_id","parts"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"completed":{"type":"boolean","const":true}},"required":["completed"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/upload/multipart/abort":{"post":{"operationId":"createWorkspaceMediaUploadMultipartAbort","summary":"Abort a multipart media upload","description":"Abort a multipart media upload.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storage_key":{"type":"string","minLength":1},"upload_id":{"type":"string","minLength":1}},"required":["storage_key","upload_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"aborted":{"type":"boolean","const":true}},"required":["aborted"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/upload/finalize":{"post":{"operationId":"createWorkspaceMediaUploadFinalize","summary":"Finalize a media upload after presigned PUT","description":"Finalize a media upload after presigned PUT.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storage_key":{"type":"string","minLength":1},"file_name":{"type":"string","minLength":1,"maxLength":200},"content_type":{"type":"string","minLength":1},"file_size_bytes":{"type":"number","exclusiveMinimum":0},"auto_process_enabled":{"type":"boolean"},"auto_transcribe":{"type":"boolean"},"auto_describe_after_transcribe":{"type":"boolean"},"auto_suggest_shorts":{"type":"boolean"}},"required":["storage_key","file_name","content_type","file_size_bytes"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"asset_type":{"type":"string"},"processing_status":{"type":"string"},"processing_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"deduped":{"type":"boolean"},"follow_up":{"type":"object","properties":{"transcription_requested":{"type":"boolean"},"description_requested":{"type":"boolean"},"short_suggestions_requested":{"type":"boolean"}},"required":["transcription_requested","description_requested","short_suggestions_requested"],"additionalProperties":false}},"required":["id","name","asset_type","processing_status","processing_run_id","deduped","follow_up"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/import/youtube":{"post":{"operationId":"createWorkspaceMediaImportYoutube","summary":"Import a YouTube video into workspace media library","description":"Import a YouTube video into workspace media library.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"quality":{"type":"string","enum":["144p","180p","240p","270p","360p","480p","540p","720p","1080p","1440p","2160p"]},"fps":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"audio_language":{"anyOf":[{"type":"string","minLength":2,"maxLength":32},{"type":"null"}]}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"status":{"type":"string","enum":["processing","already_exists"]},"quality":{"anyOf":[{"type":"string","enum":["144p","180p","240p","270p","360p","480p","540p","720p","1080p","1440p","2160p"]},{"type":"null"}]},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"txid":{"type":"number"}},"required":["asset_id","status","quality","run_id","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/import/google-drive":{"post":{"operationId":"createWorkspaceMediaImportGoogleDrive","summary":"Import a Google Drive video into workspace media library","description":"Import a Google Drive video into workspace media library.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"folder_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"short_suggestion_content_profile":{"type":"string","enum":["auto","podcast"]},"auto_trim_silence":{"type":"boolean"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"status":{"type":"string","enum":["processing","already_exists"]},"provider":{"type":"string","const":"google_drive"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"txid":{"type":"number"}},"required":["asset_id","status","provider","run_id","txid"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/short-suggestions":{"get":{"operationId":"getWorkspaceMediaAssetsAssetIdShortSuggestions","summary":"List native short suggestions for an asset","description":"List native short suggestions for an asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"offset","schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"saved":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["saved","draft","dismissed"]},"title":{"type":"string"},"hook":{"type":"string"},"transcript_excerpt":{"type":"string"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"ai_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","status","title","hook","transcript_excerpt","call_to_action","start_seconds","end_seconds","duration_seconds","ai_run_id","metadata","created_at","updated_at","thumbnail_url","thumbnail_expires_at"],"additionalProperties":false}},"drafts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["saved","draft","dismissed"]},"title":{"type":"string"},"hook":{"type":"string"},"transcript_excerpt":{"type":"string"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_seconds":{"type":"number"},"end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"ai_run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnail_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","status","title","hook","transcript_excerpt","call_to_action","start_seconds","end_seconds","duration_seconds","ai_run_id","metadata","created_at","updated_at","thumbnail_url","thumbnail_expires_at"],"additionalProperties":false}},"bounds":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["saved","drafts"]},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"returned":{"type":"integer","minimum":0,"maximum":9007199254740991},"hasMore":{"type":"boolean"},"truncated":{"type":"boolean"}},"required":["name","offset","limit","total","returned","hasMore","truncated"],"additionalProperties":false}}},"required":["collections"],"additionalProperties":false}},"required":["saved","drafts","bounds"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createWorkspaceMediaAssetsAssetIdShortSuggestions","summary":"Generate native short suggestions for an asset","description":"Generate native short suggestions for an asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content_profile":{"default":"auto","type":"string","enum":["auto","podcast"]},"auto_trim_silence":{"default":false,"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string"}},"required":["run_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/short-suggestions/{suggestionId}/thumbnail":{"post":{"operationId":"createWorkspaceMediaAssetsAssetIdShortSuggestionsSuggestionIdThumbnail","summary":"Regenerate a short suggestion thumbnail","description":"Regenerate a short suggestion thumbnail.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true},{"in":"path","name":"suggestionId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"suggestion_id":{"type":"string"},"status":{"type":"string","const":"queued"},"run_id":{"type":"string"}},"required":["suggestion_id","status","run_id"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/short-suggestions/{suggestionId}/apply":{"post":{"operationId":"createWorkspaceMediaAssetsAssetIdShortSuggestionsSuggestionIdApply","summary":"Apply a short suggestion to a project timeline","description":"Apply a short suggestion to a project timeline.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true},{"in":"path","name":"suggestionId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"caption_style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"mark_saved":{"type":"boolean"},"allow_unverified_export":{"type":"boolean"},"automatic_layout":{"type":"object","properties":{"enabled":{"type":"boolean"},"content_type_hint":{"type":"string","enum":["auto","podcast","tutorial","generic"]},"layout_strategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]},"aspect_ratio_override":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]}},"required":["enabled","content_type_hint","layout_strategy","aspect_ratio_override"]}},"required":["project_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"project_id":{"type":"string"},"asset_id":{"type":"string"},"suggestion_id":{"type":"string"},"suggestion_status":{"type":"string","enum":["saved","draft","dismissed"]},"timeline_item_id":{"type":"string"},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"duration_seconds":{"type":"number"},"source_duration_seconds":{"type":"number"},"captions_added":{"type":"number"},"caption_style_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"automatic_layout_attempted":{"type":"boolean"},"automatic_layout_applied":{"type":"boolean"},"automatic_layout_fallback_used":{"type":"boolean"},"speaker_aware_applied":{"type":"boolean"},"visual_qa_status":{"type":"string","enum":["not_required","pending","passed","failed","bypassed"]},"visual_qa_required":{"type":"boolean"},"visual_qa_passed":{"type":"boolean"},"preview_frame_count":{"type":"number"},"qa_bypassed":{"type":"boolean"},"visual_qa":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","warning","critical"]},"title":{"type":"string"},"details":{"type":"string"},"suggested_fix":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["severity","title","details","suggested_fix"],"additionalProperties":false}},"suggested_next_edits":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"previews":{"type":"array","items":{"type":"object","properties":{"preview_url":{"type":"string"},"expires_at":{"type":"string"},"storage_key":{"type":"string"},"frame":{"type":"number"},"time_seconds":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"image_format":{"type":"string","enum":["jpeg","png"]}},"required":["preview_url","expires_at","storage_key","frame","time_seconds","width","height","image_format"],"additionalProperties":false}},"visual_debug":{"anyOf":[{"type":"object","properties":{"layout_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"visible_media_rect":{"anyOf":[{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["left","top","width","height"],"additionalProperties":false},{"type":"null"}]},"active_split_gap_rect":{"anyOf":[{"type":"object","properties":{"left":{"type":"number"},"top":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["left","top","width","height"],"additionalProperties":false},{"type":"null"}]}},"required":["layout_key","visible_media_rect","active_split_gap_rect"],"additionalProperties":false},{"type":"null"}]}},"required":["summary","issues","suggested_next_edits","confidence","previews","visual_debug"],"additionalProperties":false},{"type":"null"}]},"primary_layout":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"analysis_status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"layout_summary":{"anyOf":[{"type":"object","properties":{"primary_layout":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"layouts_used":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"segment_count":{"type":"number"},"split_segment_count":{"type":"number"},"focus_segment_count":{"type":"number"},"letterbox_segment_count":{"type":"number"},"fallback_segment_count":{"type":"number"}},"required":["primary_layout","layouts_used","segment_count","split_segment_count","focus_segment_count","letterbox_segment_count","fallback_segment_count"],"additionalProperties":false},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["success","project_id","asset_id","suggestion_id","suggestion_status","timeline_item_id","trim_start_seconds","trim_end_seconds","duration_seconds","source_duration_seconds","captions_added","caption_style_id","automatic_layout_attempted","automatic_layout_applied","automatic_layout_fallback_used","speaker_aware_applied","visual_qa_status","visual_qa_required","visual_qa_passed","preview_frame_count","qa_bypassed","visual_qa","primary_layout","analysis_status","analysis_version","layout_summary","warnings"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/reframes/{reframeId}":{"get":{"operationId":"getReframeComposition","summary":"Get one editable Reframe composition and its source views","description":"Get one editable Reframe composition and its source views.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"reframeId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"reframe_id":{"type":"string"},"project_id":{"type":"string"},"timeline_item_id":{"type":"string"},"plan_id":{"type":"string"},"plan_revision":{"type":"string"},"requested_layout_strategy":{"anyOf":[{"type":"string"},{"type":"null"}]},"content_type_hint":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_count":{"type":"number"},"segment_count":{"type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"views":{"type":"array","items":{"type":"object","properties":{"timeline_item_id":{"type":"string"},"source_asset_id":{"type":"string"},"source_name":{"type":"string"},"start_units":{"type":"string"},"duration_units":{"type":"string"},"source_start_units":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_end_units":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_crop":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"canvas_rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"planner_mode":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"sync_group_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"ignored":{"type":"boolean"},"volume":{"type":"number"}},"required":["timeline_item_id","source_asset_id","source_name","start_units","duration_units","source_start_units","source_end_units","source_crop","canvas_rect","planner_mode","sync_group_id","ignored","volume"],"additionalProperties":false}}},"required":["reframe_id","project_id","timeline_item_id","plan_id","plan_revision","requested_layout_strategy","content_type_hint","source_count","segment_count","created_at","updated_at","views"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/reframes/{reframeId}/sources/{sourceAssetId}":{"patch":{"operationId":"updateReframeCompositionSource","summary":"Update one source across a Reframe composition","description":"Update one source across a Reframe composition.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"reframeId","schema":{"type":"string"},"required":true},{"in":"path","name":"sourceAssetId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_crop":{"anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"]},{"type":"null"}]},"source_offset_units":{"anyOf":[{"type":"string","pattern":"^-?\\d+$"},{"type":"null"}]},"ignored":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"replacement_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["source_crop","source_offset_units","ignored","replacement_asset_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"reframe_id":{"type":"string"},"project_id":{"type":"string"},"source_asset_id":{"type":"string"},"affected_timeline_item_ids":{"type":"array","items":{"type":"string"}}},"required":["success","reframe_id","project_id","source_asset_id","affected_timeline_item_ids"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/reframe-analysis":{"get":{"operationId":"getWorkspaceMediaAssetsAssetIdReframeAnalysis","summary":"Get automatic layout analysis status for a media asset","description":"Get automatic layout analysis status for a media asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_classification":{"anyOf":[{"type":"string","enum":["unknown","single_speaker","podcast_two_up","tutorial_screencast"]},{"type":"null"}]},"classification_confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_template_key":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"dominant_speaker_side":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"frames_analyzed":{"anyOf":[{"type":"number"},{"type":"null"}]},"low_confidence":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["status","analysis_version","error_message","primary_classification","classification_confidence","fallback_template_key","dominant_speaker_side","frames_analyzed","low_confidence"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"createWorkspaceMediaAssetsAssetIdReframeAnalysis","summary":"Queue or confirm automatic layout analysis for a media asset","description":"Queue or confirm automatic layout analysis for a media asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"asset_id":{"type":"string"},"status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"triggered":{"type":"boolean"}},"required":["success","asset_id","status","run_id","analysis_version","triggered"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/reframe-plan":{"post":{"operationId":"createWorkspaceMediaAssetsAssetIdReframePlan","summary":"Generate an inspectable automatic layout plan for a media asset","description":"Generate an inspectable automatic layout plan for a media asset.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"trim_start_seconds":{"type":"number","minimum":0},"trim_end_seconds":{"type":"number","minimum":0},"content_type_hint":{"type":"string","enum":["auto","podcast","tutorial","generic"]},"layout_strategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]}},"required":["project_id","aspect_ratio","trim_start_seconds","trim_end_seconds","content_type_hint","layout_strategy"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"analysis":{"type":"object","properties":{"status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_classification":{"anyOf":[{"type":"string","enum":["unknown","single_speaker","podcast_two_up","tutorial_screencast"]},{"type":"null"}]},"classification_confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_template_key":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"dominant_speaker_side":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"frames_analyzed":{"anyOf":[{"type":"number"},{"type":"null"}]},"low_confidence":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["status","analysis_version","error_message","primary_classification","classification_confidence","fallback_template_key","dominant_speaker_side","frames_analyzed","low_confidence"],"additionalProperties":false},"layout_summary":{"type":"object","properties":{"primary_layout":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"layouts_used":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"segment_count":{"type":"number"},"split_segment_count":{"type":"number"},"focus_segment_count":{"type":"number"},"letterbox_segment_count":{"type":"number"},"fallback_segment_count":{"type":"number"}},"required":["primary_layout","layouts_used","segment_count","split_segment_count","focus_segment_count","letterbox_segment_count","fallback_segment_count"],"additionalProperties":false},"segments":{"type":"array","items":{"type":"object","properties":{"segment_key":{"type":"string"},"layout_key":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"output_start_seconds":{"type":"number"},"output_duration_seconds":{"type":"number"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"views":{"type":"array","items":{"type":"object","properties":{"sync_role":{"type":"string","enum":["primary","secondary","tertiary","quaternary"]},"layer_index":{"type":"number"},"source_crop":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"canvas_rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"mask_shape":{"type":"string","enum":["none","rounded","circle"]},"mask_radius":{"type":"number"}},"required":["sync_role","layer_index","source_crop","canvas_rect","fit_mode","mask_shape","mask_radius"],"additionalProperties":false}}},"required":["segment_key","layout_key","trim_start_seconds","trim_end_seconds","output_start_seconds","output_duration_seconds","confidence","fallback_reason","notes","views"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["asset_id","project_id","aspect_ratio","trim_start_seconds","trim_end_seconds","analysis","layout_summary","segments","warnings"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/reframe-plan/preview":{"post":{"operationId":"createWorkspaceMediaAssetsAssetIdReframePlanPreview","summary":"Generate an automatic layout plan plus preview frames before apply","description":"Generate an automatic layout plan plus preview frames before apply.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"trim_start_seconds":{"type":"number","minimum":0},"trim_end_seconds":{"type":"number","minimum":0},"content_type_hint":{"type":"string","enum":["auto","podcast","tutorial","generic"]},"layout_strategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]},"preview_times_seconds":{"anyOf":[{"type":"array","items":{"type":"number","minimum":0}},{"type":"null"}]},"target_width":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"image_format":{"anyOf":[{"type":"string","enum":["jpeg","png"]},{"type":"null"}]}},"required":["project_id","aspect_ratio","trim_start_seconds","trim_end_seconds","content_type_hint","layout_strategy","preview_times_seconds","target_width","image_format"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"analysis":{"type":"object","properties":{"status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_classification":{"anyOf":[{"type":"string","enum":["unknown","single_speaker","podcast_two_up","tutorial_screencast"]},{"type":"null"}]},"classification_confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_template_key":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"dominant_speaker_side":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"frames_analyzed":{"anyOf":[{"type":"number"},{"type":"null"}]},"low_confidence":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["status","analysis_version","error_message","primary_classification","classification_confidence","fallback_template_key","dominant_speaker_side","frames_analyzed","low_confidence"],"additionalProperties":false},"layout_summary":{"type":"object","properties":{"primary_layout":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"layouts_used":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"segment_count":{"type":"number"},"split_segment_count":{"type":"number"},"focus_segment_count":{"type":"number"},"letterbox_segment_count":{"type":"number"},"fallback_segment_count":{"type":"number"}},"required":["primary_layout","layouts_used","segment_count","split_segment_count","focus_segment_count","letterbox_segment_count","fallback_segment_count"],"additionalProperties":false},"segments":{"type":"array","items":{"type":"object","properties":{"segment_key":{"type":"string"},"layout_key":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"output_start_seconds":{"type":"number"},"output_duration_seconds":{"type":"number"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"views":{"type":"array","items":{"type":"object","properties":{"sync_role":{"type":"string","enum":["primary","secondary","tertiary","quaternary"]},"layer_index":{"type":"number"},"source_crop":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"canvas_rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"mask_shape":{"type":"string","enum":["none","rounded","circle"]},"mask_radius":{"type":"number"}},"required":["sync_role","layer_index","source_crop","canvas_rect","fit_mode","mask_shape","mask_radius"],"additionalProperties":false}}},"required":["segment_key","layout_key","trim_start_seconds","trim_end_seconds","output_start_seconds","output_duration_seconds","confidence","fallback_reason","notes","views"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}},"previews":{"type":"array","items":{"type":"object","properties":{"preview_url":{"type":"string"},"expires_at":{"type":"string"},"storage_key":{"type":"string"},"frame":{"type":"number"},"time_seconds":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"image_format":{"type":"string","enum":["jpeg","png"]}},"required":["preview_url","expires_at","storage_key","frame","time_seconds","width","height","image_format"],"additionalProperties":false}}},"required":["asset_id","project_id","aspect_ratio","trim_start_seconds","trim_end_seconds","analysis","layout_summary","segments","warnings","previews"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/workspace/media/assets/{assetId}/reframe-plan/apply":{"post":{"operationId":"createWorkspaceMediaAssetsAssetIdReframePlanApply","summary":"Apply an automatic layout plan to a project timeline","description":"Apply an automatic layout plan to a project timeline.","tags":["Media Library"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"assetId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"expected_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"replace_timeline_item_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string","enum":["9:16","16:9","1:1","4:5"]},{"type":"null"}]},"trim_start_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"trim_end_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"content_type_hint":{"type":"string","enum":["auto","podcast","tutorial","generic"]},"layout_strategy":{"type":"string","enum":["auto","demo","letterbox","split","focus","speaker_grid","webinar","webinar_stack","gameplay"]}},"required":["project_id","expected_revision","replace_timeline_item_id","aspect_ratio","trim_start_seconds","trim_end_seconds","content_type_hint","layout_strategy"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"asset_id":{"type":"string"},"project_id":{"type":"string"},"reframe_id":{"type":"string"},"timeline_item_id":{"type":"string"},"primary_timeline_item_id":{"type":"string"},"timeline_item_ids":{"type":"array","items":{"type":"string"}},"base_revision":{"type":"number"},"revision":{"type":"number"},"aspect_ratio":{"type":"string","enum":["9:16","16:9","1:1","4:5"]},"analysis":{"type":"object","properties":{"status":{"type":"string","enum":["missing","pending","processing","completed","failed"]},"analysis_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_classification":{"anyOf":[{"type":"string","enum":["unknown","single_speaker","podcast_two_up","tutorial_screencast"]},{"type":"null"}]},"classification_confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_template_key":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"dominant_speaker_side":{"anyOf":[{"type":"string","enum":["left","right"]},{"type":"null"}]},"frames_analyzed":{"anyOf":[{"type":"number"},{"type":"null"}]},"low_confidence":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["status","analysis_version","error_message","primary_classification","classification_confidence","fallback_template_key","dominant_speaker_side","frames_analyzed","low_confidence"],"additionalProperties":false},"layout_summary":{"type":"object","properties":{"primary_layout":{"anyOf":[{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},{"type":"null"}]},"layouts_used":{"type":"array","items":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]}},"segment_count":{"type":"number"},"split_segment_count":{"type":"number"},"focus_segment_count":{"type":"number"},"letterbox_segment_count":{"type":"number"},"fallback_segment_count":{"type":"number"}},"required":["primary_layout","layouts_used","segment_count","split_segment_count","focus_segment_count","letterbox_segment_count","fallback_segment_count"],"additionalProperties":false},"segments":{"type":"array","items":{"type":"object","properties":{"segment_key":{"type":"string"},"layout_key":{"type":"string","enum":["manual","legacy","portrait_landscape_letterbox","portrait_dual_speaker_split","portrait_dual_speaker_focus_cut","portrait_tutorial_screen_focus","portrait_tutorial_facecam_stack","portrait_speaker_grid","portrait_webinar_facecam_stack","portrait_webinar_speaker_stack","portrait_gameplay_facecam_stack"]},"trim_start_seconds":{"type":"number"},"trim_end_seconds":{"type":"number"},"output_start_seconds":{"type":"number"},"output_duration_seconds":{"type":"number"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"views":{"type":"array","items":{"type":"object","properties":{"sync_role":{"type":"string","enum":["primary","secondary","tertiary","quaternary"]},"layer_index":{"type":"number"},"source_crop":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"canvas_rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["x","y","width","height"],"additionalProperties":false},"fit_mode":{"type":"string","enum":["contain","cover","stretch"]},"mask_shape":{"type":"string","enum":["none","rounded","circle"]},"mask_radius":{"type":"number"}},"required":["sync_role","layer_index","source_crop","canvas_rect","fit_mode","mask_shape","mask_radius"],"additionalProperties":false}}},"required":["segment_key","layout_key","trim_start_seconds","trim_end_seconds","output_start_seconds","output_duration_seconds","confidence","fallback_reason","notes","views"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["success","asset_id","project_id","reframe_id","timeline_item_id","primary_timeline_item_id","timeline_item_ids","base_revision","revision","aspect_ratio","analysis","layout_summary","segments","warnings"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/settings":{"get":{"operationId":"getProjectsProjectIdSettings","summary":"Get project settings","description":"Get project settings.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"anyOf":[{"type":"string"},{"type":"null"}]},"frame_rate":{"anyOf":[{"type":"string"},{"type":"null"}]},"timeline_fps":{"anyOf":[{"type":"number"},{"type":"null"}]},"units_per_frame":{"anyOf":[{"type":"number"},{"type":"null"}]},"theme":{"anyOf":[{"type":"string"},{"type":"null"}]},"font_size":{"anyOf":[{"type":"number"},{"type":"null"}]},"caption_settings":{"anyOf":[{},{"type":"null"}]},"show_scene_progress":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"auto_save":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"auto_save_interval":{"anyOf":[{"type":"number"},{"type":"null"}]},"background_color":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme_colors":{"anyOf":[{},{"type":"null"}]},"is_template":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"template_type":{"anyOf":[{"type":"string","enum":["intro","outro","full","overlay"]},{"type":"null"}]},"template_visibility":{"anyOf":[{"type":"string","enum":["private","shared","public"]},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","description","aspect_ratio","resolution","frame_rate","timeline_fps","units_per_frame","theme","font_size","caption_settings","show_scene_progress","auto_save","auto_save_interval","background_color","theme_colors","is_template","template_type","template_visibility","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/templates":{"get":{"operationId":"getProjectsProjectIdTemplates","summary":"List available templates","description":"List available templates.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"query","name":"type","schema":{"anyOf":[{"type":"string","enum":["intro","outro","full","overlay"]},{"type":"null"}]}},{"in":"query","name":"visibility","schema":{"type":"string","enum":["own","team","public","all"]}},{"in":"query","name":"search","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"number","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"template_id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["intro","outro","full","overlay"]},{"type":"null"}]},"visibility":{"type":"string","enum":["private","shared","public"]},"duration_seconds":{"type":"number"},"variable_count":{"type":"number"},"preview_thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"owner_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_own":{"type":"boolean"}},"required":["template_id","name","description","type","visibility","duration_seconds","variable_count","preview_thumbnail_url","owner_name","is_own"],"additionalProperties":false}}},"required":["templates"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/templates/{templateId}":{"get":{"operationId":"getProjectsProjectIdTemplatesTemplateId","summary":"Get template details","description":"Get template details.","tags":["Project Management"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true},{"in":"path","name":"templateId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"template_id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["intro","outro","full","overlay"]},{"type":"null"}]},"visibility":{"type":"string","enum":["private","shared","public"]},"duration_seconds":{"type":"number"},"variables":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["text","image","color"]},"default_value":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":{"type":"boolean"}},"required":["id","key","name","type","default_value","required"],"additionalProperties":false}},"timeline_item_summary":{"type":"object","properties":{"fill_layer_count":{"type":"number"},"caption_count":{"type":"number"},"total_item_count":{"type":"number"}},"required":["fill_layer_count","caption_count","total_item_count"],"additionalProperties":false},"preview_thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["template_id","name","description","type","visibility","duration_seconds","variables","timeline_item_summary","preview_thumbnail_url"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/publishing/connections":{"get":{"operationId":"getPublishingConnections","summary":"List publishing connections","description":"List publishing connections.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"connections":{"type":"array","items":{"type":"object","properties":{"connection_id":{"type":"string"},"platform":{"type":"string","enum":["youtube","instagram","facebook","tiktok"]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","needs_reauth","revoked","disabled","error"]},"external_account_id":{"type":"string"}},"required":["connection_id","platform","username","display_name","status","external_account_id"],"additionalProperties":false}},"count":{"type":"number"}},"required":["connections","count"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/publishing/video/schedule":{"post":{"operationId":"createPublishingVideoSchedule","summary":"Schedule an uploaded video","description":"Schedule one workspace video asset to YouTube, Instagram, Facebook, or TikTok without requiring an existing BlitzReels project.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_asset_id":{"type":"string"},"project_name":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"caption":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"contains_synthetic_media":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"scheduled_for":{"type":"string"},"timezone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"include_affiliate_cta":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"affiliate_tracking_url":{"anyOf":[{"type":"string","maxLength":500,"format":"uri"},{"type":"null"}]},"affiliate_cta_text":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"targets":{"minItems":1,"maxItems":4,"type":"array","items":{"oneOf":[{"type":"object","properties":{"platform":{"type":"string","const":"youtube"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"privacy_status":{"anyOf":[{"type":"string","enum":["private","unlisted","public"]},{"type":"null"}]}},"required":["platform"]},{"type":"object","properties":{"platform":{"type":"string","const":"instagram"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"trial_reel":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"trial_graduation_strategy":{"anyOf":[{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]},{"type":"null"}]},"share_to_feed":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["platform"]},{"type":"object","properties":{"platform":{"type":"string","const":"facebook"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]}},"required":["platform"]},{"type":"object","properties":{"platform":{"type":"string","const":"tiktok"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"publish_mode":{"anyOf":[{"type":"string","enum":["direct_post","draft"]},{"type":"null"}]},"privacy_level":{"anyOf":[{"type":"string","enum":["PUBLIC_TO_EVERYONE","FOLLOWER_OF_CREATOR","MUTUAL_FOLLOW_FRIENDS","SELF_ONLY"]},{"type":"null"}]},"allow_comment":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"allow_duet":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"allow_stitch":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"cover_timestamp_ms":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commercial_content_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"brand_organic":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"branded_content":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"is_ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"consent_accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["platform"]}],"type":"object"}}},"required":["media_asset_id","scheduled_for","targets"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"status":{"type":"string","const":"scheduled"},"scheduled_for":{"type":"string"},"project_id":{"type":"string"},"export_id":{"type":"string"},"source":{"type":"string","const":"media_asset"},"source_media_asset_id":{"type":"string"},"targets":{"type":"array","items":{"type":"object","properties":{"target_id":{"type":"string"},"connection_id":{"type":"string"},"platform":{"type":"string","enum":["youtube","instagram","facebook","tiktok"]},"status":{"type":"string","enum":["scheduled","publishing","processing","published","draft_sent","retrying","failed","cancelled","manual_required"]}},"required":["target_id","connection_id","platform","status"],"additionalProperties":false}},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["post_id","status","scheduled_for","project_id","export_id","source","source_media_asset_id","targets","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/projects/{projectId}/publishing/instagram":{"post":{"operationId":"createProjectsProjectIdPublishingInstagram","summary":"Schedule Instagram publish","description":"Schedule a completed project export for Instagram. MP4/MOV exports publish as Reels; ZIP carousel exports with JPEG slides publish as carousel posts. Trial mode is only applied to Reels. Optional include_affiliate_cta appends a Try BlitzReels for free line plus the actor's Affonso tracking URL (or affiliate_tracking_url override).","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"projectId","schema":{"type":"string"},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string","maxLength":2200},{"type":"null"}]},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"trial_reel":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"trial_graduation_strategy":{"anyOf":[{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]},{"type":"null"}]},"share_to_feed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"include_affiliate_cta":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"affiliate_tracking_url":{"anyOf":[{"type":"string","maxLength":500,"format":"uri"},{"type":"null"}]},"affiliate_cta_text":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"target_id":{"type":"string"},"platform":{"type":"string","const":"instagram"},"status":{"type":"string","enum":["scheduled","publishing","processing","published","retrying","failed","cancelled","manual_required"]},"scheduled_for":{"type":"string"},"connection_id":{"type":"string"},"export_id":{"type":"string"},"project_id":{"type":"string"},"publish_kind":{"type":"string","enum":["reel","trial_reel","carousel"]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["post_id","target_id","platform","status","scheduled_for","connection_id","export_id","project_id","publish_kind","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/publishing/tiktok/schedule":{"post":{"operationId":"createPublishingTiktokSchedule","summary":"Schedule TikTok publishing","description":"Schedule a completed BlitzReels video or slideshow export, or create a slideshow from ordered workspace image assets. Supports TikTok direct posting and inbox drafts.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"media_asset_ids":{"anyOf":[{"minItems":1,"maxItems":35,"type":"array","items":{"type":"string"}},{"type":"null"}]},"project_name":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}]},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"publish_mode":{"anyOf":[{"type":"string","enum":["direct_post","draft"]},{"type":"null"}]},"privacy_level":{"anyOf":[{"type":"string","enum":["PUBLIC_TO_EVERYONE","FOLLOWER_OF_CREATOR","MUTUAL_FOLLOW_FRIENDS","SELF_ONLY"]},{"type":"null"}]},"allow_comment":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"allow_duet":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"allow_stitch":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"cover_timestamp_ms":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"photo_cover_index":{"anyOf":[{"type":"integer","minimum":0,"maximum":34},{"type":"null"}]},"auto_add_music":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"commercial_content_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"brand_organic":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"branded_content":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"is_ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"consent_accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"target_id":{"type":"string"},"platform":{"type":"string","const":"tiktok"},"status":{"type":"string","enum":["scheduled","publishing","processing","published","draft_sent","retrying","failed","cancelled","manual_required"]},"scheduled_for":{"type":"string"},"connection_id":{"type":"string"},"export_id":{"type":"string"},"project_id":{"type":"string"},"source":{"type":"string","enum":["project_export","media_assets"]},"source_media_asset_ids":{"type":"array","items":{"type":"string"}},"media_type":{"type":"string","enum":["video","photo"]},"publish_mode":{"type":"string","enum":["direct_post","draft"]},"next_actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"path":{"type":"string"},"reason":{"type":"string"}},"required":["method","path","reason"],"additionalProperties":false}}},"required":["post_id","target_id","platform","status","scheduled_for","connection_id","export_id","project_id","source","source_media_asset_ids","media_type","publish_mode","next_actions"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/webhooks":{"post":{"operationId":"createWebhooks","summary":"Create webhook","description":"Create webhook.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["project.created","media.uploaded","transcription.complete","transcription.failed","faceless.complete","faceless.failed","export.ready","export.failed","job.complete","job.failed"]}},"secret":{"type":"string"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"secret":{"type":"string"},"created_at":{"type":"string"}},"required":["id","url","events","secret","created_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"get":{"operationId":"getWebhooks","summary":"List webhooks","description":"List webhooks.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"webhooks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"secret":{"type":"string"},"created_at":{"type":"string"}},"required":["id","url","events","secret","created_at"],"additionalProperties":false}}},"required":["webhooks"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/webhooks/{webhookId}":{"get":{"operationId":"getWebhooksWebhookId","summary":"Get webhook details","description":"Get webhook details.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"webhookId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"secret":{"type":"string"},"created_at":{"type":"string"}},"required":["id","url","events","secret","created_at"],"additionalProperties":false},{"type":"null"}]}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"delete":{"operationId":"deleteWebhooksWebhookId","summary":"Delete webhook","description":"Delete webhook.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"in":"path","name":"webhookId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/credits/balance":{"get":{"operationId":"getCreditsBalance","summary":"Get credits balance","description":"Returns the current AI credit balance including monthly and permanent pools.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"monthly":{"type":"object","properties":{"used":{"type":"number"},"limit":{"type":"number"},"remaining":{"type":"number"}},"required":["used","limit","remaining"],"additionalProperties":false},"permanent":{"type":"object","properties":{"remaining":{"type":"number"}},"required":["remaining"],"additionalProperties":false},"total":{"type":"number"}},"required":["monthly","permanent","total"],"additionalProperties":false}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/formats/video-model-benchmark/runs":{"post":{"operationId":"createFormatsVideoModelBenchmarkRuns","summary":"Run a branded two-model video benchmark","description":"Creates a 16:9 project, sends one exact prompt to two text-to-video models, waits for both generated media assets to finish processing, and composes a muted branded split-screen comparison. The response includes aggregate estimated credits plus job and project IDs. Poll the job until terminal, then inspect the project timeline before export.","tags":["Platform"],"security":[{"ApiKeyAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":10,"maxLength":2000},"left_model":{"default":"wan-2.1","type":"string","enum":["minimax-hailuo-2.3-pro-t2v","minimax-h3-max-t2v","luma-ray-3.2-t2v","veo3-fast","gemini-omni-flash-t2v","wan-2.1","wan-2.7-t2v","wan-3.0-t2v","happy-horse-t2v","pixverse-v6-t2v","krea-wan-14b-t2v","grok-imagine-t2v","sora-2-t2v","sora-2-pro-t2v","seedance-2.0-pro-t2v","seedance-2.5-t2v","seedance-2.0-pro-fast-t2v","seedance-1.5-pro-t2v","seedance-1.0-pro-t2v","seedance-1.0-pro-fast-t2v","seedance-1.0-lite-t2v","kling-o3-standard-t2v","kling-o3-pro-t2v","kling-v3-standard-t2v","kling-v3-pro-t2v","ltx-2-19b-t2v","ltx-2-19b-distilled-t2v"]},"right_model":{"default":"krea-wan-14b-t2v","type":"string","enum":["minimax-hailuo-2.3-pro-t2v","minimax-h3-max-t2v","luma-ray-3.2-t2v","veo3-fast","gemini-omni-flash-t2v","wan-2.1","wan-2.7-t2v","wan-3.0-t2v","happy-horse-t2v","pixverse-v6-t2v","krea-wan-14b-t2v","grok-imagine-t2v","sora-2-t2v","sora-2-pro-t2v","seedance-2.0-pro-t2v","seedance-2.5-t2v","seedance-2.0-pro-fast-t2v","seedance-1.5-pro-t2v","seedance-1.0-pro-t2v","seedance-1.0-pro-fast-t2v","seedance-1.0-lite-t2v","kling-o3-standard-t2v","kling-o3-pro-t2v","kling-v3-standard-t2v","kling-v3-pro-t2v","ltx-2-19b-t2v","ltx-2-19b-distilled-t2v"]},"duration_seconds":{"default":5,"type":"integer","minimum":2,"maximum":15},"left_label":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":48},{"type":"null"}]},"right_label":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":48},{"type":"null"}]},"brand_label":{"default":"blitzreels","type":"string","minLength":1,"maxLength":48},"project_name":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]}},"required":["prompt"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"format_id":{"type":"string","const":"video-model-benchmark"},"job_id":{"type":"string"},"project_id":{"type":"string"},"status":{"type":"string","const":"queued"},"left_model":{"type":"string"},"right_model":{"type":"string"},"duration_seconds":{"type":"number"},"estimated_credits":{"type":"number"},"estimated_seconds":{"type":"number"},"created_at":{"type":"string"},"input_warnings":{"type":"array","items":{"type":"string"}},"plan":{"type":"object","properties":{"aspect_ratio":{"type":"string","const":"16:9"},"layout":{"type":"string","const":"split-screen"},"audio":{"type":"string","const":"muted"},"left":{"type":"object","properties":{"model":{"type":"string"},"label":{"type":"string"}},"required":["model","label"],"additionalProperties":false},"right":{"type":"object","properties":{"model":{"type":"string"},"label":{"type":"string"}},"required":["model","label"],"additionalProperties":false},"brand_label":{"type":"string"}},"required":["aspect_ratio","layout","audio","left","right","brand_label"],"additionalProperties":false}},"required":["format_id","job_id","project_id","status","left_model","right_model","duration_seconds","estimated_credits","estimated_seconds","created_at","input_warnings","plan"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}}},"components":{"schemas":{"error.BAD_REQUEST":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Invalid input data"},"code":{"type":"string","description":"The error code","example":"BAD_REQUEST"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Invalid input data error (400)","description":"The error information","example":{"code":"BAD_REQUEST","message":"Invalid input data","issues":[]}},"error.UNAUTHORIZED":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Authorization not provided"},"code":{"type":"string","description":"The error code","example":"UNAUTHORIZED"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Authorization not provided error (401)","description":"The error information","example":{"code":"UNAUTHORIZED","message":"Authorization not provided","issues":[]}},"error.FORBIDDEN":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Insufficient access"},"code":{"type":"string","description":"The error code","example":"FORBIDDEN"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Insufficient access error (403)","description":"The error information","example":{"code":"FORBIDDEN","message":"Insufficient access","issues":[]}},"error.INTERNAL_SERVER_ERROR":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Internal server error"},"code":{"type":"string","description":"The error code","example":"INTERNAL_SERVER_ERROR"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Internal server error error (500)","description":"The error information","example":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]}},"error.NOT_FOUND":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Not found"},"code":{"type":"string","description":"The error code","example":"NOT_FOUND"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Not found error (404)","description":"The error information","example":{"code":"NOT_FOUND","message":"Not found","issues":[]}}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Use `Bearer br_live_...`."}}}}