{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}
Apply many video edits
Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.
{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}
Authorizations
Authorization
string
header
required
API key obtained from your Tella account settings
Path Parameters
id
string
required
Unique video identifier
Example:
"vid_abc123def456"
Body
application/json
Add, update, and remove up to 200 sound effects, text overlays, shape overlays, zooms, blurs, highlights, image/video overlays, and layouts in one editor revision. Operations run in array order; the complete batch is validated before anything is applied. Cuts, transcript edits, clip settings, and auto layouts are not batchable.
operations
object[]
required
Required array length: 1 - 200 elements
One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.
Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Option 7
Option 8
Option 9
Option 10
Option 11
Option 12
Option 13
Option 14
Option 15
Option 16
Option 17
Option 18
Option 19
Option 20
Option 21
Option 22
Option 23
Option 24
Hide child attributes
operations.clipId
string
required
Clip ID
Minimum string length: 1
operations.durationMs
integer
required
Required range: 0 < x <= 9007199254740991
Example:
3000
operations.operationId
string
required
Caller-chosen ID used to match this operation to its result. Must be unique within the batch.
Minimum string length: 1
Example:
"sound-1"
operations.startTimeMs
integer
required
Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.
Required range: 0 <= x <= 9007199254740991
Example:
1000
operations.type
enum<string>
required
Available options:
add_sound_effect
operations.name
string
Example:
"Whoosh"
operations.presetId
string
Preset ID of a curated Tella sound effect, from a default item in GET /v1/library?scope=default. Placing one copies the effect into a source owned by your workspace, so nothing needs uploading. Mutually exclusive with sourceId; exactly one is required.
Example:
"cha-ching"
operations.sourceId
string
Source ID for the audio, from POST /v1/sources (kind: audio with the audio's duration) or from a private/workspace item in GET /v1/library?type=sound-effect. When uploading, send the audio file as-is — MP3, WAV, M4A, … — no need to wrap it in an MP4. Mutually exclusive with presetId; exactly one is required.
One result per operation, in request order: the created resource ID for adds, the affected resource ID for updates and removes.
results
object[]
required
Hide child attributes
results.id
string
required
Created or affected resource ID
results.operationId
string
required
results.type
enum<string>
required
Available options:
sound_effect,
text_overlay,
shape_overlay,
zoom,
blur,
highlight,
media_overlay,
layout
revision
integer
required
Required range: 0 <= x <= 9007199254740991
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Tella","colors":{"primary":"#8278FA","light":"#B1AAFC","dark":"#5E51F8"},"logo":{"light":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf","dark":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-dark.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=88323f6b0165ce29c00e3a1d80c82fe3"},"favicon":"https://mintcdn.com/tella/munSRGpiNeMNXMvc/favicon.svg?fit=max\u0026auto=format\u0026n=munSRGpiNeMNXMvc\u0026q=85\u0026s=1b25a4dc5d9a41a1a9238eda432a0cb6","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"all","prefill":true},"url":"full","mdx":{"auth":{"method":"bearer"}}},"navbar":{"primary":{"type":"button","label":"Open Tella","href":"https://www.tella.com/videos"}},"footer":{"socials":{"github":"https://github.com/tellahq","x":"https://x.com/tellahq","linkedin":"https://linkedin.com/company/tellahq","youtube":"https://youtube.com/@tellahq","website":"https://tella.com","instagram":"https://instagram.com/tellahq"},"links":[{"header":"Tella features","items":[{"label":"Video trimming","href":"https://www.tella.com/features/video-trimming"},{"label":"Viewer downloads","href":"https://www.tella.com/features/viewer-download"},{"label":"4K export","href":"https://www.tella.com/features/4k-export"},{"label":"AI editing","href":"https://www.tella.com/features/ai-editing"},{"label":"Custom branding","href":"https://www.tella.com/features/custom-branding"},{"label":"Upload video","href":"https://www.tella.com/features/video-upload"},{"label":"Video clips","href":"https://www.tella.com/features/clips"},{"label":"Custom backgrounds","href":"https://www.tella.com/features/custom-backgrounds"},{"label":"All features","href":"https://www.tella.com/features"}]}]},"seo":{"paths":[{"path":"help","metatags":{"canonical":"https://www.tella.com"}},{"path":"changelog","metatags":{"canonical":"https://www.tella.com"}}]},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"contextual":{"options":["copy","assistant","view","chatgpt","claude","perplexity","grok","mcp","add-mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tella","hasAudioNarration":false,"actualSubdomain":"tella","customDomains":["www.tella.com"],"gitSource":{"type":"github","owner":"tellahq","repo":"tella-fusion","deployBranch":"main","contentDirectory":"packages/core/webapp/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":true},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00ef34c953c2aa6bb620f0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Help Center","count":272},{"language":"default","tag":"Developers","count":216},{"language":"default","tag":"API Reference","count":163},{"language":"default","tag":"Edit","count":75},{"language":"default","tag":"Clips","count":63},{"language":"default","tag":"Share and embed","count":41},{"language":"default","tag":"Videos","count":40},{"language":"default","tag":"MCP Tools","count":35},{"language":"default","tag":"Troubleshooting and support","count":33},{"language":"default","tag":"Account and workspace","count":31}],"searchSettings":{"isFiltersEnabled":true,"maxResults":15,"showContentSnippets":true,"fullPageSearch":true}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"type":"email","email":"support@tella.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/videos/apply-many-video-edits","slug":"/api-reference/videos/apply-many-video-edits","pageMetadata":{"title":"Apply many video edits","description":"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/edits","href":"/api-reference/videos/apply-many-video-edits","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Apply many video edits","description":"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/edits","href":"/api-reference/videos/apply-many-video-edits","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tella/0df50391d431fa00/support-chat.js","/docs/_mintlify/custom/tella/7e6fe091e3982139/lettervisit.js"],"openApiReferenceData":{"operation":{"description":"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.","operationId":"applyVideoEdits","parameters":["9075fe43-04cf-4d2f-83ca-ac0ff67c6ee1"],"requestBody":"c570e410-4f1e-4082-ad69-1cf874ce213c","responses":{"200":"7bd9d815-b99b-492a-8af0-c76b95265bb9","400":"5dc87ed5-c75e-47bd-af52-71073aaef8a9","401":"c1e79343-4f0a-48d5-b420-fd6f90c19a7b","403":"4368881b-037a-4706-b1c0-b791bf34777f","404":"869c927d-9520-413a-9c7c-4702b5585c17","409":"1652646c-87a5-450d-9bf5-00c08705b4c2","429":"5caad57b-c503-4019-a72a-84846127c070","500":"45f77d4e-fec3-4a45-8812-3cb6c9553871","501":"47153f1a-1bb1-479f-a4ad-d1963c258b99","503":"755df577-3f5a-4225-9b5e-78178c3a0c1d"},"security":["50b4a2b0-24ac-48e4-8bb8-f1c4e76a9c57"],"summary":"Apply many video edits","tags":["Videos"],"method":"post","type":"path","servers":["d2aabac2-b2bc-4b47-a6f4-a26614a56f79"],"path":"/v1/videos/{id}/edits","baseUrlOptions":["https://api.tella.com"],"title":"Apply many video edits","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.operations.items.0.oneOf.0.clipId":"\u003cstring>","body.operations.items.0.oneOf.0.durationMs":3000,"body.operations.items.0.oneOf.0.operationId":"sound-1","body.operations.items.0.oneOf.0.startTimeMs":1000,"body.operations.items.0.oneOf.0.type":"add_sound_effect","body.operations.items.0.oneOf.0.name":"Whoosh","body.operations.items.0.oneOf.0.presetId":"cha-ching","body.operations.items.0.oneOf.0.sourceId":"su_abc123","body.operations.items.0.oneOf.0.volume":1}],"urlDisplay":"full"},"dependencies":{"parameters":{"9075fe43-04cf-4d2f-83ca-ac0ff67c6ee1":{"description":"Unique video identifier","in":"path","name":"id","required":true,"schema":{"description":"Unique video identifier","example":"vid_abc123def456","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Add, update, and remove up to 200 sound effects, text overlays, shape overlays, zooms, blurs, highlights, image/video overlays, and layouts in one editor revision. Operations run in array order; the complete batch is validated before anything is applied. Cuts, transcript edits, clip settings, and auto layouts are not batchable.","properties":{"operations":{"items":{"oneOf":[{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","startTimeMs","durationMs"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.clipId","typeLabel":"string"},"durationMs":{"example":3000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.operationId","typeLabel":"string"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.startTimeMs","typeLabel":"integer"},"type":{"enum":["add_sound_effect"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"name":{"example":"Whoosh","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.0.name","typeLabel":"string"},"presetId":{"description":"Preset ID of a curated Tella sound effect, from a `default` item in `GET /v1/library?scope=default`. Placing one copies the effect into a source owned by your workspace, so nothing needs uploading. Mutually exclusive with `sourceId`; exactly one is required.","example":"cha-ching","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.0.presetId","typeLabel":"string"},"sourceId":{"description":"Source ID for the audio, from `POST /v1/sources` (`kind: audio` with the audio's duration) or from a `private`/`workspace` item in `GET /v1/library?type=sound-effect`. When uploading, send the audio file as-is — MP3, WAV, M4A, … — no need to wrap it in an MP4. Mutually exclusive with `presetId`; exactly one is required.","example":"su_abc123","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.0.sourceId","typeLabel":"string"},"volume":{"description":"Playback volume (0 = muted, 1 = original). Defaults to 1.","example":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.0.volume","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","text","startTimeMs","durationMs"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.clipId","typeLabel":"string"},"durationMs":{"example":5000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.operationId","typeLabel":"string"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.startTimeMs","typeLabel":"integer"},"text":{"example":"Welcome back","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.text","typeLabel":"string"},"type":{"enum":["add_text_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"animation":{"type":"object","description":"How the overlay enters and leaves; when set it replaces `transition`. Each side describes the hidden state the overlay moves from on the way in and back to on the way out. An omitted side stays as it is. `{intro: {preset: 'slide_up'}, outro: {preset: 'fade'}}` is a complete animation; on text, `{textIntro: {preset: 'slide_up', text: {unit: 'words'}}}` brings the words in one by one.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1.animation","typeLabel":"object"},"background":{"type":"object","description":"Background behind the text. Defaults to transparent.","required":["type","color"],"properties":{"color":{"description":"Hex color string. Required when type = 'solid'. Transparent backgrounds use #00000000.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.background.color","typeLabel":"string"},"type":{"description":"Background variant. Text overlays take a solid background; the other `ClipBackground` variants are not supported behind text.","enum":["solid"],"example":"solid","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.background.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.background","typeLabel":"object"},"backgroundPadding":{"type":"number","description":"Defaults to 0, or the preset's.","maximum":1,"minimum":0,"example":0.25,"uniqueKey":"operations.items.[INDEX].oneOf.1.backgroundPadding","typeLabel":"number"},"backgroundShape":{"type":"string","description":"Defaults to none.","enum":["none","regular","squircle"],"example":"squircle","uniqueKey":"operations.items.[INDEX].oneOf.1.backgroundShape","typeLabel":"enum\u003cstring>"},"color":{"description":"Defaults to white.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.color","typeLabel":"string"},"cornerRadius":{"type":"number","description":"Corner radius in story pixels, replacing the rounded shape's own (regular is 16 on a text background, squircle 32; on a square 12% and 24% of its shorter side). Needs a regular or squircle shape; setting the shape again without it goes back to the shape's own radius.","maximum":512,"minimum":0,"example":24,"uniqueKey":"operations.items.[INDEX].oneOf.1.cornerRadius","typeLabel":"number"},"depth":{"type":"string","description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","uniqueKey":"operations.items.[INDEX].oneOf.1.depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"operations.items.[INDEX].oneOf.1.depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"operations.items.[INDEX].oneOf.1.depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.dimensions.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"fontFamily":{"type":"string","description":"One of Tella's catalog font families. Defaults to Inter. Anything outside the catalog is rejected rather than silently falling back; use `fontId` for an uploaded font.","enum":["Inter","Roboto Mono","Archivo","Barlow","Caveat","DM Sans","Figtree","Lora","Merriweather","Montserrat","Nunito Sans","Open Sans","Oswald","Playfair Display","Poppins","Raleway","Roboto","Roboto Flex","Source Sans 3","Space Grotesk"],"example":"Inter","uniqueKey":"operations.items.[INDEX].oneOf.1.fontFamily","typeLabel":"enum\u003cstring>"},"fontId":{"type":"string","description":"A custom font from the private or workspace library: the `id` of a `font` item from GET /v1/library?type=font, such as one uploaded with POST /v1/sources (`kind: font`) and POST /v1/library. Sets the overlay's font family to that font. Don't combine with `fontFamily`.","minLength":1,"example":"media_abc123def456","uniqueKey":"operations.items.[INDEX].oneOf.1.fontId","typeLabel":"string"},"fontSize":{"description":"Font size in artboard pixels. Defaults to 7.5% of the video's shorter side, which is the editor's default and readable at any canvas size.","example":81,"exclusiveMinimum":true,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.fontSize","typeLabel":"number"},"fontWeight":{"description":"Variable-font weight axis — 100 (thin) to 900 (black), 500 by default. Values outside the chosen font's own axis range are clamped when rendered.","example":500,"maximum":1000,"minimum":1,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.fontWeight","typeLabel":"number"},"fontWidth":{"description":"Variable-font width axis, as a percentage — 100 is normal, 50 ultra-condensed, 150 extra-expanded, 100 by default. Values outside the chosen font's own axis range are clamped when rendered.","example":100,"exclusiveMinimum":true,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.1.fontWidth","typeLabel":"number"},"letterSpacing":{"type":"number","description":"Defaults to 0, or the preset's.","maximum":1,"minimum":-0.2,"example":-0.02,"uniqueKey":"operations.items.[INDEX].oneOf.1.letterSpacing","typeLabel":"number"},"lineHeight":{"type":"number","description":"Defaults to 1.2, or the preset's.","maximum":3,"minimum":0.8,"example":1.5,"uniqueKey":"operations.items.[INDEX].oneOf.1.lineHeight","typeLabel":"number"},"outline":{"oneOf":[{"type":"string","description":"Defaults to no outline, or the preset's.","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","example":"#000000FF","uniqueKey":"operations.items.[INDEX].oneOf.1.outline.oneOf.0","typeLabel":"string"},{"type":"null","description":"Defaults to no outline, or the preset's.","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","example":"#000000FF","uniqueKey":"operations.items.[INDEX].oneOf.1.outline.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.1.outline","typeLabel":"string | null"},"point":{"type":"object","description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.1.point","typeLabel":"object"},"presetId":{"description":"A preset from GET /v1/text-presets — `default:\u003cid>` for a built-in style or a saved preset's ID. Supplies the font, weight, width, color, size, alignment, tracking, background, background shape, background padding and outline (not the shadow); any of those fields sent alongside overrides the preset's value.","example":"default:label","minLength":1,"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.1.presetId","typeLabel":"string"},"shadow":{"type":"string","description":"Defaults to none.","enum":["none","subtle","deep"],"example":"subtle","uniqueKey":"operations.items.[INDEX].oneOf.1.shadow","typeLabel":"enum\u003cstring>"},"textAlign":{"type":"string","description":"Defaults to center.","enum":["left","center","right"],"example":"center","uniqueKey":"operations.items.[INDEX].oneOf.1.textAlign","typeLabel":"enum\u003cstring>"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the text in at its start and out at its end, `hard_cut` pops it in and out. An `animation` replaces it while set.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.1.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","zoomType","startTimeMs","durationMs","scale"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.clipId","typeLabel":"string"},"durationMs":{"example":2000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.operationId","typeLabel":"string"},"scale":{"description":"Magnification factor (1 = no zoom, 3.5 = max). Required — a zoom without a scale cannot be rendered.","example":2,"maximum":3.5,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.scale","typeLabel":"number"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.startTimeMs","typeLabel":"integer"},"type":{"enum":["add_zoom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"zoomType":{"description":"Zoom variant: manualZoom or trackingZoom.","enum":["manualZoom","trackingZoom"],"example":"manualZoom","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.zoomType","typeLabel":"enum\u003cstring>"},"focusPoint":{"type":"object","description":"Point on the zoomed footage to zoom into, expressed as percentages of its dimensions. Required for `manualZoom`; ignored for `trackingZoom`.","required":["xPct","yPct"],"properties":{"xPct":{"description":"Horizontal position on the screen frame (0-100). 0 = left edge.","example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.focusPoint.xPct","typeLabel":"number"},"yPct":{"description":"Vertical position on the screen frame (0-100). 0 = top edge.","example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.focusPoint.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.2.focusPoint","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","startTimeMs","durationMs","point","dimensions"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.clipId","typeLabel":"string"},"dimensions":{"description":"Size of the masked rectangle (percentages)","properties":{"heightPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.dimensions.heightPct","typeLabel":"number"},"widthPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.dimensions.widthPct","typeLabel":"number"}},"required":["widthPct","heightPct"],"type":"object","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.dimensions","typeLabel":"object"},"durationMs":{"example":2000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.operationId","typeLabel":"string"},"point":{"description":"Top-left corner of the masked rectangle (percentages)","properties":{"xPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.point.xPct","typeLabel":"number"},"yPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.point","typeLabel":"object"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.startTimeMs","typeLabel":"integer"},"type":{"enum":["add_blur"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"intensity":{"description":"Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).","example":0.7,"maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.3.intensity","typeLabel":"number"},"transition":{"type":"string","description":"`smooth` fades the mask in and out, `hard_cut` pops it. New masks start on `hard_cut`.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.3.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","startTimeMs","durationMs","point","dimensions"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.clipId","typeLabel":"string"},"dimensions":{"description":"Size of the masked rectangle (percentages)","properties":{"heightPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.dimensions.heightPct","typeLabel":"number"},"widthPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.dimensions.widthPct","typeLabel":"number"}},"required":["widthPct","heightPct"],"type":"object","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.dimensions","typeLabel":"object"},"durationMs":{"example":2000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.operationId","typeLabel":"string"},"point":{"description":"Top-left corner of the masked rectangle (percentages)","properties":{"xPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.point.xPct","typeLabel":"number"},"yPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.point.yPct","typeLabel":"number"}},"required":["xPct","yPct"],"type":"object","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.point","typeLabel":"object"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.startTimeMs","typeLabel":"integer"},"type":{"enum":["add_highlight"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"cornerRadius":{"description":"Corner radius from 0 to 64, in the clip's corner units (`regular` is the video's corner radius, 16 by default, and `squircle` twice that). Overrides the `corners` preset's radius, so it needs `corners` regular or squircle (in the request or already set); setting `corners` without it goes back to the preset's radius. Absent when the preset's radius applies.","example":24,"maximum":64,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.4.cornerRadius","typeLabel":"number"},"corners":{"description":"How the highlighted area's corners are rounded. `auto` (the default) follows the clip's `corners`; the others override it for this highlight. Highlights only.","enum":["auto","none","regular","squircle"],"example":"regular","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.4.corners","typeLabel":"enum\u003cstring>"},"intensity":{"description":"Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).","example":0.7,"maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.4.intensity","typeLabel":"number"},"transition":{"type":"string","description":"`smooth` fades the mask in and out, `hard_cut` pops it. New masks start on `hard_cut`.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.4.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","startTimeMs","durationMs"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.clipId","typeLabel":"string"},"durationMs":{"example":5000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.operationId","typeLabel":"string"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.startTimeMs","typeLabel":"integer"},"type":{"enum":["add_media_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"animation":{"type":"object","description":"How the overlay enters and leaves; when set it replaces `transition`. Each side describes the hidden state the overlay moves from on the way in and back to on the way out. An omitted side stays as it is. `{intro: {preset: 'slide_up'}, outro: {preset: 'fade'}}` is a complete animation; on text, `{textIntro: {preset: 'slide_up', text: {unit: 'words'}}}` brings the words in one by one.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.5.animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5.animation","typeLabel":"object"},"depth":{"type":"string","description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","uniqueKey":"operations.items.[INDEX].oneOf.5.depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"operations.items.[INDEX].oneOf.5.depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"operations.items.[INDEX].oneOf.5.depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.dimensions.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.5.dimensions","typeLabel":"object"},"motionDocumentId":{"description":"In place of `sourceId`: a Tella Motion document of this video's (ffd_…, from `POST /v1/motion/documents`), shown as the overlay. It is linked, not copied: it plays live, so edits to the document show in the video at once.","example":"ffd_abc123","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.motionDocumentId","typeLabel":"string"},"name":{"example":"Logo","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.name","typeLabel":"string"},"point":{"type":"object","description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.5.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.5.point","typeLabel":"object"},"sourceId":{"description":"Source ID from `POST /v1/sources` (`kind: image` or `kind: video`). The overlay type follows the source's kind. Pass this or `motionDocumentId`.","example":"su_abc123","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.5.sourceId","typeLabel":"string"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the overlay in at its start and out at its end, `hard_cut` pops it in and out. An `animation` replaces it while set.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.5.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","zoomId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.6.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.6.operationId","typeLabel":"string"},"type":{"enum":["update_zoom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"zoomId":{"description":"Zoom ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.6.zoomId","typeLabel":"string"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.6.durationMs","typeLabel":"integer"},"focusPoint":{"type":"object","description":"Point on the zoomed footage to zoom into, expressed as percentages of its dimensions. Required for `manualZoom`; ignored for `trackingZoom`.","required":["xPct","yPct"],"properties":{"xPct":{"description":"Horizontal position on the screen frame (0-100). 0 = left edge.","example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.6.focusPoint.xPct","typeLabel":"number"},"yPct":{"description":"Vertical position on the screen frame (0-100). 0 = top edge.","example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.6.focusPoint.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.6.focusPoint","typeLabel":"object"},"scale":{"description":"Magnification factor (1 = no zoom, 3.5 = max).","example":2,"maximum":3.5,"minimum":1,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.6.scale","typeLabel":"number"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.6.startTimeMs","typeLabel":"integer"},"zoomType":{"description":"Zoom variant: manualZoom or trackingZoom.","enum":["manualZoom","trackingZoom"],"example":"manualZoom","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.6.zoomType","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","zoomId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.7.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.7.operationId","typeLabel":"string"},"type":{"enum":["remove_zoom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"zoomId":{"description":"Zoom ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.7.zoomId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","maskId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.clipId","typeLabel":"string"},"maskId":{"description":"Blur ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.maskId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.operationId","typeLabel":"string"},"type":{"enum":["update_blur"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Size of the masked rectangle (percentages)","required":["widthPct","heightPct"],"properties":{"heightPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.dimensions.heightPct","typeLabel":"number"},"widthPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.dimensions.widthPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.8.dimensions","typeLabel":"object"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.8.durationMs","typeLabel":"integer"},"intensity":{"description":"Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).","example":0.7,"maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.8.intensity","typeLabel":"number"},"point":{"type":"object","description":"Top-left corner of the masked rectangle (percentages)","required":["xPct","yPct"],"properties":{"xPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.point.xPct","typeLabel":"number"},"yPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.8.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.8.point","typeLabel":"object"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.8.startTimeMs","typeLabel":"integer"},"transition":{"type":"string","description":"`smooth` fades the mask in and out, `hard_cut` pops it. New masks start on `hard_cut`.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.8.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","maskId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.9.clipId","typeLabel":"string"},"maskId":{"description":"Blur ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.9.maskId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.9.operationId","typeLabel":"string"},"type":{"enum":["remove_blur"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","maskId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.clipId","typeLabel":"string"},"maskId":{"description":"Highlight ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.maskId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.operationId","typeLabel":"string"},"type":{"enum":["update_highlight"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"cornerRadius":{"description":"Corner radius from 0 to 64, in the clip's corner units (`regular` is the video's corner radius, 16 by default, and `squircle` twice that). Overrides the `corners` preset's radius, so it needs `corners` regular or squircle (in the request or already set); setting `corners` without it goes back to the preset's radius. Absent when the preset's radius applies.","example":24,"maximum":64,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.10.cornerRadius","typeLabel":"number"},"corners":{"description":"How the highlighted area's corners are rounded. `auto` (the default) follows the clip's `corners`; the others override it for this highlight. Highlights only.","enum":["auto","none","regular","squircle"],"example":"regular","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.10.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Size of the masked rectangle (percentages)","required":["widthPct","heightPct"],"properties":{"heightPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.dimensions.heightPct","typeLabel":"number"},"widthPct":{"example":50,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.dimensions.widthPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.10.dimensions","typeLabel":"object"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.10.durationMs","typeLabel":"integer"},"intensity":{"description":"Strength from 0 to 1. Blur: 0 is the standard blur and 1 blurs three times as heavily; the content stays fully hidden at every value (defaults to 0). Highlight: how dark the area outside the highlight goes, 0 = no dimming, 1 = black (defaults to 0.7).","example":0.7,"maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.10.intensity","typeLabel":"number"},"point":{"type":"object","description":"Top-left corner of the masked rectangle (percentages)","required":["xPct","yPct"],"properties":{"xPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.point.xPct","typeLabel":"number"},"yPct":{"example":25,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.10.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.10.point","typeLabel":"object"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.10.startTimeMs","typeLabel":"integer"},"transition":{"type":"string","description":"`smooth` fades the mask in and out, `hard_cut` pops it. New masks start on `hard_cut`.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.10.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","maskId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.11.clipId","typeLabel":"string"},"maskId":{"description":"Highlight ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.11.maskId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.11.operationId","typeLabel":"string"},"type":{"enum":["remove_highlight"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.11.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","overlayId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.operationId","typeLabel":"string"},"overlayId":{"description":"Overlay ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.overlayId","typeLabel":"string"},"type":{"enum":["update_media_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.type","typeLabel":"enum\u003cstring>"},"animation":{"oneOf":[{"type":"object","description":"Animate how the overlay enters and leaves. An omitted `intro`/`outro` keeps that side. Null removes the animation, so `transition` plays again.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.12.animation.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.12.animation","typeLabel":"object | null"},"depth":{"type":"string","description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","uniqueKey":"operations.items.[INDEX].oneOf.12.depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"operations.items.[INDEX].oneOf.12.depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"operations.items.[INDEX].oneOf.12.depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.dimensions.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.12.dimensions","typeLabel":"object"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.12.durationMs","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.12.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.12.point","typeLabel":"object"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.12.startTimeMs","typeLabel":"integer"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the overlay in at its start and out at its end, `hard_cut` pops it in and out. An `animation` replaces it while set; setting `transition` without `animation` removes the animation.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.12.transition","typeLabel":"enum\u003cstring>"},"zIndex":{"description":"Stacking position among the clip's image, video and text overlays: 0 is the backmost. `depth` applies first — a `behind_presenter` overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number. A value past the top moves the overlay to the front; the other overlays keep their relative order.","example":0,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.12.zIndex","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","overlayId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.13.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.13.operationId","typeLabel":"string"},"overlayId":{"description":"Overlay ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.13.overlayId","typeLabel":"string"},"type":{"enum":["remove_media_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.13.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","textOverlayId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.operationId","typeLabel":"string"},"textOverlayId":{"description":"Text overlay ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.textOverlayId","typeLabel":"string"},"type":{"enum":["update_text_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.type","typeLabel":"enum\u003cstring>"},"animation":{"oneOf":[{"type":"object","description":"Animate how the overlay enters and leaves. An omitted `intro`/`outro` keeps that side. Null removes the animation, so `transition` plays again.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.14.animation.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.animation","typeLabel":"object | null"},"background":{"type":"object","description":"Background behind a text overlay, in the same object shape as a clip background.","required":["type","color"],"properties":{"color":{"description":"Hex color string. Required when type = 'solid'. Transparent backgrounds use #00000000.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.background.color","typeLabel":"string"},"type":{"description":"Background variant. Text overlays take a solid background; the other `ClipBackground` variants are not supported behind text.","enum":["solid"],"example":"solid","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.background.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.background","typeLabel":"object"},"backgroundPadding":{"type":"number","description":"Extra room around the text inside its background, as a fraction of the font size added on every side (0.5 at an 80px font adds 40px). 0 is the standard padding. No effect without a visible background.","maximum":1,"minimum":0,"example":0.25,"uniqueKey":"operations.items.[INDEX].oneOf.14.backgroundPadding","typeLabel":"number"},"backgroundShape":{"type":"string","description":"Shape of the solid background behind the text.","enum":["none","regular","squircle"],"example":"squircle","uniqueKey":"operations.items.[INDEX].oneOf.14.backgroundShape","typeLabel":"enum\u003cstring>"},"color":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.color","typeLabel":"string"},"cornerRadius":{"oneOf":[{"type":"number","description":"The background's own corner radius in story pixels, or null for its shape's.","maximum":512,"minimum":0,"example":24,"uniqueKey":"operations.items.[INDEX].oneOf.14.cornerRadius.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.14.cornerRadius.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.cornerRadius","typeLabel":"number | null"},"depth":{"type":"string","description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","uniqueKey":"operations.items.[INDEX].oneOf.14.depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"operations.items.[INDEX].oneOf.14.depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"operations.items.[INDEX].oneOf.14.depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.dimensions.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.dimensions","typeLabel":"object"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.14.durationMs","typeLabel":"integer"},"fontFamily":{"type":"string","description":"One of Tella's catalog font families — the same list the editor's font picker offers.","enum":["Inter","Roboto Mono","Archivo","Barlow","Caveat","DM Sans","Figtree","Lora","Merriweather","Montserrat","Nunito Sans","Open Sans","Oswald","Playfair Display","Poppins","Raleway","Roboto","Roboto Flex","Source Sans 3","Space Grotesk"],"example":"Inter","uniqueKey":"operations.items.[INDEX].oneOf.14.fontFamily","typeLabel":"enum\u003cstring>"},"fontId":{"type":"string","description":"A custom font from the private or workspace library: the `id` of a `font` item from GET /v1/library?type=font, such as one uploaded with POST /v1/sources (`kind: font`) and POST /v1/library. Sets the overlay's font family to that font. Don't combine with `fontFamily`.","minLength":1,"example":"media_abc123def456","uniqueKey":"operations.items.[INDEX].oneOf.14.fontId","typeLabel":"string"},"fontSize":{"description":"Font size in artboard pixels.","exclusiveMinimum":true,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.fontSize","typeLabel":"number"},"fontWeight":{"maximum":1000,"minimum":1,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.fontWeight","typeLabel":"number"},"fontWidth":{"exclusiveMinimum":true,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.14.fontWidth","typeLabel":"number"},"letterSpacing":{"type":"number","description":"Tracking: space between letters, as a fraction of the font size (-0.05 at an 80px font pulls letters 4px closer; 0.1 spreads them 8px apart). Negative tightens; 0 is the font's own spacing.","maximum":1,"minimum":-0.2,"example":-0.02,"uniqueKey":"operations.items.[INDEX].oneOf.14.letterSpacing","typeLabel":"number"},"lineHeight":{"type":"number","description":"Distance between baselines, as a multiple of the font size (1.5 at an 80px font puts lines 120px apart). 1.2 is the standard spacing.","maximum":3,"minimum":0.8,"example":1.5,"uniqueKey":"operations.items.[INDEX].oneOf.14.lineHeight","typeLabel":"number"},"outline":{"oneOf":[{"type":"string","description":"Set an outline color, or null to remove the outline.","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","example":"#000000FF","uniqueKey":"operations.items.[INDEX].oneOf.14.outline.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set an outline color, or null to remove the outline.","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","example":"#000000FF","uniqueKey":"operations.items.[INDEX].oneOf.14.outline.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.14.outline","typeLabel":"string | null"},"point":{"type":"object","description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.14.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.14.point","typeLabel":"object"},"presetId":{"description":"Restyle the overlay with a preset from GET /v1/text-presets; its text, timing and placement stay. Style fields sent alongside override the preset's values.","example":"default:label","minLength":1,"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.presetId","typeLabel":"string"},"shadow":{"type":"string","description":"Drop shadow, matching the editor's Shadow menu. It falls from the background box when the text has one, else from the letters.","enum":["none","subtle","deep"],"example":"subtle","uniqueKey":"operations.items.[INDEX].oneOf.14.shadow","typeLabel":"enum\u003cstring>"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.14.startTimeMs","typeLabel":"integer"},"text":{"minLength":1,"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.14.text","typeLabel":"string"},"textAlign":{"type":"string","description":"Horizontal alignment of the text inside its overlay box.","enum":["left","center","right"],"example":"center","uniqueKey":"operations.items.[INDEX].oneOf.14.textAlign","typeLabel":"enum\u003cstring>"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the text in at its start and out at its end, `hard_cut` pops it in and out. An `animation` replaces it while set; setting `transition` without `animation` removes the animation.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.14.transition","typeLabel":"enum\u003cstring>"},"zIndex":{"description":"Stacking position among the clip's image, video and text overlays: 0 is the backmost. `depth` applies first — a `behind_presenter` overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number. A value past the top moves the overlay to the front; the other overlays keep their relative order.","example":0,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.14.zIndex","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","textOverlayId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.15.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.15.operationId","typeLabel":"string"},"textOverlayId":{"description":"Text overlay ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.15.textOverlayId","typeLabel":"string"},"type":{"enum":["remove_text_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.15.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.15","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","startTimeMs","durationMs"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.clipId","typeLabel":"string"},"durationMs":{"example":5000,"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.durationMs","typeLabel":"integer"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.operationId","typeLabel":"string"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","example":1000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.startTimeMs","typeLabel":"integer"},"type":{"enum":["add_shape_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.type","typeLabel":"enum\u003cstring>"},"animation":{"type":"object","description":"How the overlay enters and leaves; when set it replaces `transition`. Each side describes the hidden state the overlay moves from on the way in and back to on the way out. An omitted side stays as it is. `{intro: {preset: 'slide_up'}, outro: {preset: 'fade'}}` is a complete animation; on text, `{textIntro: {preset: 'slide_up', text: {unit: 'words'}}}` brings the words in one by one.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16.animation","typeLabel":"object"},"border":{"oneOf":[{"type":"object","description":"A line just inside the outline, or null for none.","required":["color","width"],"properties":{"color":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.border.oneOf.0.color","typeLabel":"string"},"width":{"description":"Artboard pixels, drawn inside the outline.","exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.border.oneOf.0.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.border.oneOf.0","typeLabel":"object"},{"type":"null","description":"A line just inside the outline, or null for none.","required":["color","width"],"properties":{"color":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string"},"width":{"description":"Artboard pixels, drawn inside the outline.","exclusiveMinimum":true,"minimum":0,"type":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.border.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.border","typeLabel":"object | null"},"cornerRadius":{"type":"number","description":"Corner radius in story pixels, replacing the rounded shape's own (regular is 16 on a text background, squircle 32; on a square 12% and 24% of its shorter side). Needs a regular or squircle shape; setting the shape again without it goes back to the shape's own radius.","maximum":512,"minimum":0,"example":24,"uniqueKey":"operations.items.[INDEX].oneOf.16.cornerRadius","typeLabel":"number"},"corners":{"type":"string","description":"How a square's corners are rounded.","enum":["none","regular","squircle"],"example":"squircle","uniqueKey":"operations.items.[INDEX].oneOf.16.corners","typeLabel":"enum\u003cstring>"},"depth":{"type":"string","description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","uniqueKey":"operations.items.[INDEX].oneOf.16.depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"operations.items.[INDEX].oneOf.16.depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"operations.items.[INDEX].oneOf.16.depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.dimensions.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.dimensions","typeLabel":"object"},"fill":{"type":"object","description":"What fills the shape, cut to its outline: any clip background except `ambient`. A solid `#00000000` leaves only the border.","required":["type"],"properties":{"type":{"description":"Background variant. `ambient`: the clip's screen, else its camera, heavily blurred; no other fields. `shaderGradient`: an animated gradient set by `shaderGradientPreset`; echoing a non-preset one unchanged keeps it.","enum":["solid","gradient","image","video","shaderGradient","ambient"],"example":"solid","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.type","typeLabel":"enum\u003cstring>"},"color":{"oneOf":[{"description":"Hex color string. Required when type = 'solid'.","example":"#000000ff","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.color.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'solid'.","example":"#000000ff","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.color","typeLabel":"string | null"},"gradientAngle":{"oneOf":[{"description":"Linear gradient angle in degrees. Required when type = 'gradient'.","example":45,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientAngle.oneOf.0","typeLabel":"integer"},{"description":"Linear gradient angle in degrees. Required when type = 'gradient'.","example":45,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientAngle.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientAngle","typeLabel":"integer | null"},"gradientColor1":{"oneOf":[{"description":"Hex color string. Required when type = 'gradient'.","example":"#ff0080ff","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientColor1.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'gradient'.","example":"#ff0080ff","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientColor1.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientColor1","typeLabel":"string | null"},"gradientColor2":{"oneOf":[{"description":"Hex color string. Required when type = 'gradient'.","example":"#7928caff","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientColor2.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'gradient'.","example":"#7928caff","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientColor2.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.gradientColor2","typeLabel":"string | null"},"imageUrl":{"oneOf":[{"description":"Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.imageUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.imageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.imageUrl","typeLabel":"string\u003curi> | null"},"shaderGradientPreset":{"oneOf":[{"description":"Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'.","example":"Halo","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.shaderGradientPreset.oneOf.0","typeLabel":"string"},{"description":"Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'.","example":"Halo","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.shaderGradientPreset.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.shaderGradientPreset","typeLabel":"string | null"},"sourceId":{"oneOf":[{"description":"Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.","example":"su_abc123","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.sourceId.oneOf.0","typeLabel":"string"},{"description":"Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.","example":"su_abc123","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.sourceId","typeLabel":"string | null"},"videoDurationSeconds":{"oneOf":[{"description":"Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.","example":12.4,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.videoDurationSeconds.oneOf.0","typeLabel":"number"},{"description":"Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.","example":12.4,"minimum":0,"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.videoDurationSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.videoDurationSeconds","typeLabel":"number | null"},"videoUrl":{"oneOf":[{"description":"Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.videoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.16.fill.videoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.16.fill.videoUrl","typeLabel":"string\u003curi> | null"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.fill","typeLabel":"object"},"name":{"description":"Label in the editor's timeline.","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.name","typeLabel":"string"},"path":{"description":"A custom outline as SVG path data (`d`) in a 0–100 box; it stretches with the overlay box. Sending it makes the shape a `path`. Closed subpaths (ending in Z) are filled; an open path shows only its `border`, drawn centred on the line.","example":"M50 0 L100 100 L0 100 Z","maxLength":10000,"minLength":1,"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.16.path","typeLabel":"string"},"point":{"type":"object","description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.16.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.16.point","typeLabel":"object"},"shadow":{"type":"string","description":"Drop shadow, matching the editor's Shadow menu. It falls from the background box when the text has one, else from the letters.","enum":["none","subtle","deep"],"example":"subtle","uniqueKey":"operations.items.[INDEX].oneOf.16.shadow","typeLabel":"enum\u003cstring>"},"shapeType":{"type":"string","description":"The outline, stretched to fill the overlay box: a non-square box makes a rectangle or an oval. `path` draws the overlay's own `path`.","enum":["square","circle","triangle","diamond","star","hexagon","arrow","path"],"uniqueKey":"operations.items.[INDEX].oneOf.16.shapeType","typeLabel":"enum\u003cstring>"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the shape in and out, `hard_cut` pops it. An `animation` replaces it while set.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.16.transition","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.16","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","shapeOverlayId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.operationId","typeLabel":"string"},"shapeOverlayId":{"description":"Shape overlay ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.shapeOverlayId","typeLabel":"string"},"type":{"enum":["update_shape_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.type","typeLabel":"enum\u003cstring>"},"animation":{"oneOf":[{"type":"object","description":"Animate how the shape enters and leaves. An omitted `intro`/`outro` keeps that side. Null removes the animation, so `transition` plays again.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.animation.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.animation","typeLabel":"object | null"},"border":{"oneOf":[{"type":"object","description":"A line just inside the outline, or null for none.","required":["color","width"],"properties":{"color":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.border.oneOf.0.color","typeLabel":"string"},"width":{"description":"Artboard pixels, drawn inside the outline.","exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.border.oneOf.0.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.border.oneOf.0","typeLabel":"object"},{"type":"null","description":"A line just inside the outline, or null for none.","required":["color","width"],"properties":{"color":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#FFFFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string"},"width":{"description":"Artboard pixels, drawn inside the outline.","exclusiveMinimum":true,"minimum":0,"type":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.border.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.border","typeLabel":"object | null"},"cornerRadius":{"oneOf":[{"type":"number","description":"The corners' own radius in story pixels, or null for their preset's.","maximum":512,"minimum":0,"example":24,"uniqueKey":"operations.items.[INDEX].oneOf.17.cornerRadius.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.cornerRadius.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.cornerRadius","typeLabel":"number | null"},"corners":{"type":"string","description":"How a square's corners are rounded.","enum":["none","regular","squircle"],"example":"squircle","uniqueKey":"operations.items.[INDEX].oneOf.17.corners","typeLabel":"enum\u003cstring>"},"depth":{"type":"string","description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","uniqueKey":"operations.items.[INDEX].oneOf.17.depth","typeLabel":"enum\u003cstring>"},"depthChanges":{"type":"array","items":{"additionalProperties":false,"properties":{"atMs":{"description":"Ms after the overlay starts.","example":1200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.depthChanges.items.[INDEX].atMs","typeLabel":"number"},"depth":{"description":"Where the overlay sits relative to the presenter: the person in the clip's camera recording, or in its uploaded footage when the clip has no camera. `front` paints over everything. `behind_presenter` paints it behind the person but over everything else: in any layout the person is matted out of their footage and redrawn above the overlay. Fullscreen and framed layouts keep the recorded room around them; a cut-out layout replaces the room with the clip background. New overlays start on `front`. Without a presenter the overlay paints in front either way.","enum":["front","behind_presenter"],"example":"behind_presenter","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.depthChanges.items.[INDEX].depth","typeLabel":"enum\u003cstring>"}},"required":["atMs","depth"],"type":"object","uniqueKey":"operations.items.[INDEX].oneOf.17.depthChanges.items.[INDEX]","typeLabel":"object"},"description":"Changes of `depth` over the overlay's own time, each held until the next: `atMs` after the overlay starts it moves to that depth, so one overlay can pass in front of the presenter and back behind them (a ring orbiting their head, a title they step in front of). `depth` is where it starts. On updates, omit it to leave the changes as they are; `[]` removes them. Absent in responses while the overlay holds one depth.","uniqueKey":"operations.items.[INDEX].oneOf.17.depthChanges","typeLabel":"object[]"},"dimensions":{"type":"object","description":"Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change. Both sides must be greater than 0 — the renderer lays the overlay out into this box, so a zero or negative side has no valid meaning.","required":["width","height"],"properties":{"height":{"example":540,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.dimensions.height","typeLabel":"number"},"width":{"example":960,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.dimensions.width","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.dimensions","typeLabel":"object"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.17.durationMs","typeLabel":"integer"},"fill":{"type":"object","description":"What fills the shape, cut to its outline: any clip background except `ambient`. A solid `#00000000` leaves only the border.","required":["type"],"properties":{"type":{"description":"Background variant. `ambient`: the clip's screen, else its camera, heavily blurred; no other fields. `shaderGradient`: an animated gradient set by `shaderGradientPreset`; echoing a non-preset one unchanged keeps it.","enum":["solid","gradient","image","video","shaderGradient","ambient"],"example":"solid","type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.type","typeLabel":"enum\u003cstring>"},"color":{"oneOf":[{"description":"Hex color string. Required when type = 'solid'.","example":"#000000ff","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.color.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'solid'.","example":"#000000ff","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.color","typeLabel":"string | null"},"gradientAngle":{"oneOf":[{"description":"Linear gradient angle in degrees. Required when type = 'gradient'.","example":45,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientAngle.oneOf.0","typeLabel":"integer"},{"description":"Linear gradient angle in degrees. Required when type = 'gradient'.","example":45,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientAngle.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientAngle","typeLabel":"integer | null"},"gradientColor1":{"oneOf":[{"description":"Hex color string. Required when type = 'gradient'.","example":"#ff0080ff","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientColor1.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'gradient'.","example":"#ff0080ff","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientColor1.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientColor1","typeLabel":"string | null"},"gradientColor2":{"oneOf":[{"description":"Hex color string. Required when type = 'gradient'.","example":"#7928caff","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientColor2.oneOf.0","typeLabel":"string"},{"description":"Hex color string. Required when type = 'gradient'.","example":"#7928caff","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientColor2.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.gradientColor2","typeLabel":"string | null"},"imageUrl":{"oneOf":[{"description":"Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.imageUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.imageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.imageUrl","typeLabel":"string\u003curi> | null"},"shaderGradientPreset":{"oneOf":[{"description":"Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'.","example":"Halo","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.shaderGradientPreset.oneOf.0","typeLabel":"string"},{"description":"Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'.","example":"Halo","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.shaderGradientPreset.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.shaderGradientPreset","typeLabel":"string | null"},"sourceId":{"oneOf":[{"description":"Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.","example":"su_abc123","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.sourceId.oneOf.0","typeLabel":"string"},{"description":"Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. A video background source must have its file uploaded, be 20 MB or smaller, and not be an audio or auto capture source; it is also saved to your uploaded video backgrounds, like an upload in the editor. Input-only.","example":"su_abc123","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.sourceId","typeLabel":"string | null"},"videoDurationSeconds":{"oneOf":[{"description":"Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.","example":12.4,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.videoDurationSeconds.oneOf.0","typeLabel":"number"},{"description":"Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input.","example":12.4,"minimum":0,"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.videoDurationSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.videoDurationSeconds","typeLabel":"number | null"},"videoUrl":{"oneOf":[{"description":"Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.videoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`.","format":"uri","type":"null","uniqueKey":"operations.items.[INDEX].oneOf.17.fill.videoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.17.fill.videoUrl","typeLabel":"string\u003curi> | null"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.fill","typeLabel":"object"},"path":{"description":"A custom outline as SVG path data (`d`) in a 0–100 box; it stretches with the overlay box. Sending it makes the shape a `path`. Closed subpaths (ending in Z) are filled; an open path shows only its `border`, drawn centred on the line.","example":"M50 0 L100 100 L0 100 Z","maxLength":10000,"minLength":1,"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.17.path","typeLabel":"string"},"point":{"type":"object","description":"Top-left corner of the overlay, as a percentage of the video canvas (0-100). Relative so the anchor survives video aspect ratio changes.","required":["xPct","yPct"],"properties":{"xPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.point.xPct","typeLabel":"number"},"yPct":{"example":30,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.17.point.yPct","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.17.point","typeLabel":"object"},"shadow":{"type":"string","description":"Drop shadow, matching the editor's Shadow menu. It falls from the background box when the text has one, else from the letters.","enum":["none","subtle","deep"],"example":"subtle","uniqueKey":"operations.items.[INDEX].oneOf.17.shadow","typeLabel":"enum\u003cstring>"},"shapeType":{"type":"string","description":"The outline, stretched to fill the overlay box: a non-square box makes a rectangle or an oval. `path` draws the overlay's own `path`.","enum":["square","circle","triangle","diamond","star","hexagon","arrow","path"],"uniqueKey":"operations.items.[INDEX].oneOf.17.shapeType","typeLabel":"enum\u003cstring>"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied).","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.17.startTimeMs","typeLabel":"integer"},"transition":{"type":"string","description":"Intro/outro animation: `smooth` fades the shape in and out, `hard_cut` pops it. An `animation` replaces it while set; setting `transition` without `animation` removes the animation.","enum":["smooth","hard_cut"],"example":"smooth","uniqueKey":"operations.items.[INDEX].oneOf.17.transition","typeLabel":"enum\u003cstring>"},"zIndex":{"description":"Stacking position among the clip's image, video and text overlays: 0 is the backmost. `depth` applies first — a `behind_presenter` overlay stays behind the presenter whatever its zIndex — so the order only matters among overlays at the same depth. Lottie overlays share the stack but aren't listed, so listed values can skip a number. A value past the top moves the overlay to the front; the other overlays keep their relative order.","example":0,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.17.zIndex","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.17","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","shapeOverlayId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.18.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.18.operationId","typeLabel":"string"},"shapeOverlayId":{"description":"Shape overlay ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.18.shapeOverlayId","typeLabel":"string"},"type":{"enum":["remove_shape_overlay"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.18.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.18","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","soundEffectId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.19.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.19.operationId","typeLabel":"string"},"soundEffectId":{"description":"Sound effect ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.19.soundEffectId","typeLabel":"string"},"type":{"enum":["update_sound_effect"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.19.type","typeLabel":"enum\u003cstring>"},"durationMs":{"exclusiveMinimum":true,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.19.durationMs","typeLabel":"integer"},"startTimeMs":{"description":"Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.19.startTimeMs","typeLabel":"integer"},"volume":{"description":"Playback volume (0 = muted, 1 = original).","minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.19.volume","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.19","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","soundEffectId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.20.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.20.operationId","typeLabel":"string"},"soundEffectId":{"description":"Sound effect ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.20.soundEffectId","typeLabel":"string"},"type":{"enum":["remove_sound_effect"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.20.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.20","typeLabel":"object"},{"type":"object","description":"Add a layout. With startTimeMs and durationMs, overlapping layouts are trimmed, split, or removed to make room, exactly like the single-call add; without them the clip's base layout is set and the result ID is `base`.","required":["type","operationId","clipId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.clipId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.operationId","typeLabel":"string"},"type":{"enum":["add_layout"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.type","typeLabel":"enum\u003cstring>"},"cameraStyle":{"oneOf":[{"description":"The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: `circle`, `square`, `portrait`, `none` (a rectangle in the camera slot's aspect, rounded by the clip's `corners`, e.g. a squircle when corners are `squircle`), `cutout` (the presenter cut out of the camera feed with no frame or room, in the layout's camera position — e.g. `camera-bubble` with `style: full` and `position: bottom-left` for a full-screen recording with a cut-out presenter in the corner; it switches pop-out off), `blob` or `blob-outline`. It shapes the camera bubble and the pop-out frame. Null clears it so the layout's own shape applies; omitted leaves it as it is. Needs a camera recording and a named layout that frames the camera (not cut-out, screen-only or custom; on a custom layout set `presentation.shape`).","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.cameraStyle.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: `circle`, `square`, `portrait`, `none` (a rectangle in the camera slot's aspect, rounded by the clip's `corners`, e.g. a squircle when corners are `squircle`), `cutout` (the presenter cut out of the camera feed with no frame or room, in the layout's camera position — e.g. `camera-bubble` with `style: full` and `position: bottom-left` for a full-screen recording with a cut-out presenter in the corner; it switches pop-out off), `blob` or `blob-outline`. It shapes the camera bubble and the pop-out frame. Null clears it so the layout's own shape applies; omitted leaves it as it is. Needs a camera recording and a named layout that frames the camera (not cut-out, screen-only or custom; on a custom layout set `presentation.shape`).","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.21.cameraStyle.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.21.cameraStyle","typeLabel":"enum\u003cstring> | null"},"crop":{"oneOf":[{"type":"object","description":"Crop the clip's screen recording for this layout only — the editor's crop modal on “This layout only”. Other layouts keep following the clip's crop; `null` makes this layout follow it again. Masks that start in the layout stay anchored to their content, and a custom layout's screen box keeps its on-canvas scale unless the same request writes `layout` geometry. Needs a screen recording or an uploaded video in the clip. To crop the recording across the whole clip use auto-crop.","required":["top","right","bottom","left"],"properties":{"bottom":{"description":"Pixels of the screen recording removed from its bottom edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.crop.oneOf.0.bottom","typeLabel":"number"},"left":{"description":"Pixels of the screen recording removed from its left edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.crop.oneOf.0.left","typeLabel":"number"},"right":{"description":"Pixels of the screen recording removed from its right edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.crop.oneOf.0.right","typeLabel":"number"},"top":{"description":"Pixels of the screen recording removed from its top edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.crop.oneOf.0.top","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.21.crop.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.21.crop.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.21.crop","typeLabel":"object | null"},"durationMs":{"description":"Optional. Provide together with startTimeMs for a time-ranged layout. Minimum 200ms.","maximum":9007199254740991,"minimum":200,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.21.durationMs","typeLabel":"integer"},"layout":{"oneOf":[{"type":"object","title":"Fullscreen","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind"],"properties":{"kind":{"enum":["fullscreen"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured for basic-subject clips (Tella renders the screen fullscreen). Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.0.screenFit","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` (default) is plain fullscreen; `stretch` punches in to 1.15x. On basic-subject clips `stretch` needs uploaded footage (not a screen recording).","enum":["regular","stretch"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.0.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.0","typeLabel":"Fullscreen · object"},{"type":"object","title":"Middle","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind"],"properties":{"kind":{"enum":["middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"shape":{"description":"Required for camera-subject clips. Rejected on basic-subject clips, which have no camera.","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.1.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.1","typeLabel":"Middle · object"},{"type":"object","title":"Side by Side","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind","position","style"],"properties":{"kind":{"enum":["side-by-side"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"position":{"description":"Where the camera sits. `left`/`right` on landscape clips; `top`/`bottom` on portrait and square clips.","enum":["left","right","top","bottom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.2.position","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` weights camera and screen unevenly, `even` splits 50/50, `overlap` lets the camera bleed over the screen edge (and requires `size`), `perspective` angles the camera and screen toward each other (landscape only). Portrait and square clips support `even` only. `regular` and `overlap` scale the whole screen recording to fit its panel; `even` fills each half edge to edge and center-crops the screen to that half-canvas box (roughly half its width on a landscape canvas), with no `screenFit`/letterbox option. Avoid `even` for terminals, code, spreadsheets or other dense screen content unless you check the result with a clip frame. In the editor's layout picker these are 'Split Left/Right' (regular), 'Split Left/Right Overlap' (overlap, size M or L), 'Split Left/Right Small' (overlap, size S) and 'Split Left/Right 50/50' (even); users often call Overlap 'overlay'.","enum":["regular","even","overlap","perspective"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.2.style","typeLabel":"enum\u003cstring>"},"size":{"description":"Camera size. Required when `style: \"overlap\"`; ignored otherwise.","enum":["S","M","L"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.2.size","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.2","typeLabel":"Side by Side · object"},{"type":"object","title":"TV Presenter","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind","position","style"],"properties":{"kind":{"enum":["tv-presenter"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.3.position","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` is the standard today-show framing, `full` puts the screen fullscreen behind the presenter, `overlap` tightens the camera-screen overlap.","enum":["regular","full","overlap"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.3","typeLabel":"TV Presenter · object"},{"type":"object","title":"Cut Out","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind"],"properties":{"kind":{"enum":["cut-out"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"position":{"description":"Combi clips only (required there): which side the cut-out presenter sits on in landscape. Portrait and square stories stack the two instead — `right` puts the presenter at the top, `left` at the bottom. Ignored on camera-subject clips.","enum":["left","right"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.4.position","typeLabel":"enum\u003cstring>"},"style":{"description":"Landscape combi clips only. `regular` (default) places the screen beside the presenter; `perspective` fills most of the canvas with the screen, angled away toward the presenter, who stands in front in the bottom corner on `position`'s side.","enum":["regular","perspective"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.4.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.4","typeLabel":"Cut Out · object"},{"type":"object","title":"Camera Bubble","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind","position","size"],"properties":{"kind":{"enum":["camera-bubble"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right","top","bottom","top-left","top-right","bottom-left","bottom-right","middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5.position","typeLabel":"enum\u003cstring>"},"size":{"enum":["S","M","L"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5.size","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"full\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5.screenFit","typeLabel":"enum\u003cstring>"},"shape":{"description":"Defaults to `circle`, as in the editor's Camera Bubble picker.","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5.shape","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` (default) keeps the screen layered behind the bubble; `full` puts the screen fullscreen behind the bubble (and honours `screenFit`).","enum":["regular","full"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.5","typeLabel":"Camera Bubble · object"},{"type":"object","title":"Camera Only","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind","style"],"properties":{"kind":{"enum":["camera-only"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.6.kind","typeLabel":"enum\u003cstring>"},"style":{"description":"`fullscreen` fills the frame with the camera (optional `punchIn`); `middle` centers a shaped camera (requires `shape`).","enum":["fullscreen","middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.6.style","typeLabel":"enum\u003cstring>"},"punchIn":{"description":"Only allowed when `style: \"fullscreen\"`; `punchIn: true` with `style: \"middle\"` is rejected. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.6.punchIn","typeLabel":"boolean"},"shape":{"description":"Required when `style: \"middle\"`, rejected otherwise. Allowed shapes vary by ratio (no `portrait` in portrait clips, no `square` in square clips).","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.6.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.6","typeLabel":"Camera Only · object"},{"type":"object","title":"Screen Only","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind","style"],"properties":{"kind":{"enum":["screen-only"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.7.kind","typeLabel":"enum\u003cstring>"},"style":{"description":"`fullscreen` fills the frame with the screen (optional `screenFit`); `middle` centers the screen.","enum":["fullscreen","middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.7.style","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"fullscreen\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.7.screenFit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.7","typeLabel":"Screen Only · object"},{"type":"object","title":"Custom","description":"Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.","required":["kind"],"properties":{"kind":{"enum":["custom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.kind","typeLabel":"enum\u003cstring>"},"presentation":{"type":"object","description":"The camera on combi clips. When omitted on a clip that has a camera and no custom geometry yet, the camera is kept but hidden.","properties":{"corners":{"description":"Corner rounding of a rectangular frame. Defaults to `regular`.","enum":["none","regular","squircle"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Slot size in artboard pixels.","required":["width","height"],"properties":{"height":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.hidden","typeLabel":"boolean"},"order":{"description":"Stacking order; the lower one draws on top: 0 is the front layer and 1 the layer behind it (use only 0 and 1). Defaults to 0 for the subject and 1 for the presentation.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.order","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the slot in artboard pixels.","required":["x","y"],"properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.point","typeLabel":"object"},"shape":{"description":"Frame the layer is drawn in: `none` (default) is the plain rectangle given by `dimensions`; `circle`, `square` and `portrait` are the camera-bubble frames; `cutout` cuts the presenter out of the camera feed; `blob` is a wobbling bubble that grows toward the presenter's hands, and `blob-outline` is the same with a white line around it.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.presentation","typeLabel":"object"},"subject":{"type":"object","description":"The main layer: the screen recording on combi and basic-subject clips, the camera on camera-subject clips. A screen keeps its recording's aspect ratio: `dimensions` are fitted to it around the same centre.","properties":{"corners":{"description":"Corner rounding of a rectangular frame. Defaults to `regular`.","enum":["none","regular","squircle"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Slot size in artboard pixels.","required":["width","height"],"properties":{"height":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.hidden","typeLabel":"boolean"},"order":{"description":"Stacking order; the lower one draws on top: 0 is the front layer and 1 the layer behind it (use only 0 and 1). Defaults to 0 for the subject and 1 for the presentation.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.order","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the slot in artboard pixels.","required":["x","y"],"properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.point","typeLabel":"object"},"shape":{"description":"Frame the layer is drawn in: `none` (default) is the plain rectangle given by `dimensions`; `circle`, `square` and `portrait` are the camera-bubble frames; `cutout` cuts the presenter out of the camera feed; `blob` is a wobbling bubble that grows toward the presenter's hands, and `blob-outline` is the same with a white line around it.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8.subject","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.layout.oneOf.8","typeLabel":"Custom · object"}],"uniqueKey":"operations.items.[INDEX].oneOf.21.layout","typeLabel":"Fullscreen · object | Middle · object | Side by Side · object | TV Presenter · object | Cut Out · object | Camera Bubble · object | Camera Only · object | Screen Only · object | Custom · object"},"media":{"oneOf":[{"type":"object","title":"ClipMediaImage","description":"Optional media content to show during this layout. Only valid on time-ranged layouts.","required":["type","sourceId"],"properties":{"sourceId":{"description":"Source ID from `POST /v1/sources` (`kind: image`).","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.0.sourceId","typeLabel":"string"},"type":{"enum":["image"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.0.type","typeLabel":"enum\u003cstring>"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.0.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.0","typeLabel":"ClipMediaImage · object"},{"type":"object","title":"ClipMediaVideo","description":"Optional media content to show during this layout. Only valid on time-ranged layouts.","required":["type","sourceId"],"properties":{"sourceId":{"description":"Source ID from `POST /v1/sources`.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.1.sourceId","typeLabel":"string"},"type":{"enum":["video"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.1.type","typeLabel":"enum\u003cstring>"},"muted":{"description":"Silence the video's own audio. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.1.muted","typeLabel":"boolean"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.1.slot","typeLabel":"enum\u003cstring>"},"startTimeMs":{"description":"Where the video starts, in ms of the source itself (its in-point, like the editor's Trim). Defaults to 0. Must be inside the source; a layout longer than what is left of the source loops from this point.","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.1.startTimeMs","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.1","typeLabel":"ClipMediaVideo · object"},{"type":"object","title":"ClipMediaRecording","description":"Optional media content to show during this layout. Only valid on time-ranged layouts.","required":["type","startTimeMs"],"properties":{"startTimeMs":{"description":"Where the b-roll starts, in ms on this clip's playback timeline. It plays the recording on for the layout's duration, including any footage cut out in that stretch.","maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.2.startTimeMs","typeLabel":"integer"},"type":{"enum":["recording"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.2.type","typeLabel":"enum\u003cstring>"},"muted":{"description":"Silence the recording's own audio. Defaults to true, since it would repeat the clip's.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.2.muted","typeLabel":"boolean"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.2.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.2","typeLabel":"ClipMediaRecording · object"},{"type":"object","title":"ClipMediaMotion","description":"Optional media content to show during this layout. Only valid on time-ranged layouts.","required":["type","documentId"],"properties":{"documentId":{"description":"A Tella Motion document of this video's (ffd_…), from `POST /v1/motion/documents`.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.3.documentId","typeLabel":"string"},"type":{"enum":["motion"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.3.type","typeLabel":"enum\u003cstring>"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.3.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.media.oneOf.3","typeLabel":"ClipMediaMotion · object"}],"uniqueKey":"operations.items.[INDEX].oneOf.21.media","typeLabel":"ClipMediaImage · object | ClipMediaVideo · object | ClipMediaRecording · object | ClipMediaMotion · object"},"popOut":{"oneOf":[{"type":"object","description":"Pop the presenter out of the camera frame. Omitted or null leaves it off.","properties":{"amount":{"description":"How far the frame shrinks below the presenter, as a fraction of the camera slot (0–0.5). Defaults to 0.22.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.0.amount","typeLabel":"number"},"background":{"description":"What fills the frame behind the presenter: `original` keeps the camera feed, `color` paints `color`. Defaults to `original`.","enum":["original","color"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.0.background","typeLabel":"enum\u003cstring>"},"color":{"description":"Frame fill when `background` is `color`, as #RRGGBB or #RRGGBBAA. Defaults to #6366F1.","pattern":"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.0.color","typeLabel":"string"},"outlineColor":{"description":"Outline colour as #RRGGBB or #RRGGBBAA. Defaults to #FFFFFF.","pattern":"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.0.outlineColor","typeLabel":"string"},"outlineWidth":{"description":"Outline around the frame as a fraction of its width (0–0.05); 0 draws none. Defaults to 0.","maximum":0.05,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.0.outlineWidth","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.21.popOut.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.21.popOut","typeLabel":"object | null"},"startTimeMs":{"description":"Optional. Provide together with durationMs for a time-ranged layout. In ms on the clip's playback timeline (cuts applied).","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.21.startTimeMs","typeLabel":"integer"},"transitionStyle":{"type":"string","title":"LayoutTransitionStyle","description":"Optional. Only valid on time-ranged layouts. Defaults to the user's saved layout intro transition when omitted. The user's saved layout outro transition is applied when the following layout begins or resumes.","enum":["spring","hardCut"],"uniqueKey":"operations.items.[INDEX].oneOf.21.transitionStyle","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.21","typeLabel":"object"},{"type":"object","description":"Update a layout. Time-ranged layouts support the same b-roll media replacement and layout-shape changes as the single-call update. The base layout accepts `layout` only.","required":["type","operationId","clipId","layoutId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.clipId","typeLabel":"string"},"layoutId":{"description":"Layout ID, `base` for the clip-spanning layout, or the operationId of an add_layout operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layoutId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.operationId","typeLabel":"string"},"type":{"enum":["update_layout"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.type","typeLabel":"enum\u003cstring>"},"cameraStyle":{"oneOf":[{"description":"The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: `circle`, `square`, `portrait`, `none` (a rectangle in the camera slot's aspect, rounded by the clip's `corners`, e.g. a squircle when corners are `squircle`), `cutout` (the presenter cut out of the camera feed with no frame or room, in the layout's camera position — e.g. `camera-bubble` with `style: full` and `position: bottom-left` for a full-screen recording with a cut-out presenter in the corner; it switches pop-out off), `blob` or `blob-outline`. It shapes the camera bubble and the pop-out frame. Null clears it so the layout's own shape applies; omitted leaves it as it is. Needs a camera recording and a named layout that frames the camera (not cut-out, screen-only or custom; on a custom layout set `presentation.shape`). On the base layout it is accepted without `layout`.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.cameraStyle.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: `circle`, `square`, `portrait`, `none` (a rectangle in the camera slot's aspect, rounded by the clip's `corners`, e.g. a squircle when corners are `squircle`), `cutout` (the presenter cut out of the camera feed with no frame or room, in the layout's camera position — e.g. `camera-bubble` with `style: full` and `position: bottom-left` for a full-screen recording with a cut-out presenter in the corner; it switches pop-out off), `blob` or `blob-outline`. It shapes the camera bubble and the pop-out frame. Null clears it so the layout's own shape applies; omitted leaves it as it is. Needs a camera recording and a named layout that frames the camera (not cut-out, screen-only or custom; on a custom layout set `presentation.shape`). On the base layout it is accepted without `layout`.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.22.cameraStyle.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.22.cameraStyle","typeLabel":"enum\u003cstring> | null"},"crop":{"oneOf":[{"type":"object","description":"Crop the clip's screen recording for this layout only — the editor's crop modal on “This layout only”. Other layouts keep following the clip's crop; `null` makes this layout follow it again. Masks that start in the layout stay anchored to their content, and a custom layout's screen box keeps its on-canvas scale unless the same request writes `layout` geometry. Needs a screen recording or an uploaded video in the clip. To crop the recording across the whole clip use auto-crop.","required":["top","right","bottom","left"],"properties":{"bottom":{"description":"Pixels of the screen recording removed from its bottom edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.crop.oneOf.0.bottom","typeLabel":"number"},"left":{"description":"Pixels of the screen recording removed from its left edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.crop.oneOf.0.left","typeLabel":"number"},"right":{"description":"Pixels of the screen recording removed from its right edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.crop.oneOf.0.right","typeLabel":"number"},"top":{"description":"Pixels of the screen recording removed from its top edge","minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.crop.oneOf.0.top","typeLabel":"number"}},"uniqueKey":"operations.items.[INDEX].oneOf.22.crop.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.22.crop.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.22.crop","typeLabel":"object | null"},"durationMs":{"maximum":9007199254740991,"minimum":200,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.22.durationMs","typeLabel":"integer"},"layout":{"oneOf":[{"type":"object","title":"Fullscreen","description":"Single-layer fullscreen. Takes an optional `style` (regular/stretch); basic-subject clips also take an optional `screenFit`.","required":["kind"],"properties":{"kind":{"enum":["fullscreen"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured for basic-subject clips (Tella renders the screen fullscreen). Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.0.screenFit","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` (default) is plain fullscreen; `stretch` punches in to 1.15x. On basic-subject clips `stretch` needs uploaded footage (not a screen recording).","enum":["regular","stretch"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.0.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.0","typeLabel":"Fullscreen · object"},{"type":"object","title":"Middle","description":"Centered subject. Camera-subject clips take a `shape`; basic-subject clips take no fields.","required":["kind"],"properties":{"kind":{"enum":["middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"shape":{"description":"Required for camera-subject clips. Rejected on basic-subject clips, which have no camera.","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.1.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.1","typeLabel":"Middle · object"},{"type":"object","title":"Side by Side","description":"Camera and screen side by side. Combi (all ratios). Landscape splits horizontally (`position: left/right`, style regular/even/overlap/perspective); portrait and square split vertically 50/50 (`position: top/bottom` for the camera half, `style: even` only). Note that `even` crops the screen recording to fill its half; see `style`.","required":["kind","position","style"],"properties":{"kind":{"enum":["side-by-side"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"position":{"description":"Where the camera sits. `left`/`right` on landscape clips; `top`/`bottom` on portrait and square clips.","enum":["left","right","top","bottom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.2.position","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` weights camera and screen unevenly, `even` splits 50/50, `overlap` lets the camera bleed over the screen edge (and requires `size`), `perspective` angles the camera and screen toward each other (landscape only). Portrait and square clips support `even` only. `regular` and `overlap` scale the whole screen recording to fit its panel; `even` fills each half edge to edge and center-crops the screen to that half-canvas box (roughly half its width on a landscape canvas), with no `screenFit`/letterbox option. Avoid `even` for terminals, code, spreadsheets or other dense screen content unless you check the result with a clip frame. In the editor's layout picker these are 'Split Left/Right' (regular), 'Split Left/Right Overlap' (overlap, size M or L), 'Split Left/Right Small' (overlap, size S) and 'Split Left/Right 50/50' (even); users often call Overlap 'overlay'.","enum":["regular","even","overlap","perspective"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.2.style","typeLabel":"enum\u003cstring>"},"size":{"description":"Camera size. Required when `style: \"overlap\"`; ignored otherwise.","enum":["S","M","L"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.2.size","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.2","typeLabel":"Side by Side · object"},{"type":"object","title":"TV Presenter","description":"Today-show layout: presenter on one side, screen on the other. Combi (landscape) only.","required":["kind","position","style"],"properties":{"kind":{"enum":["tv-presenter"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.3.position","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` is the standard today-show framing, `full` puts the screen fullscreen behind the presenter, `overlap` tightens the camera-screen overlap.","enum":["regular","full","overlap"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.3","typeLabel":"TV Presenter · object"},{"type":"object","title":"Cut Out","description":"The presenter is cut out of the footage (person matting). On combi clips they are blended over the screen recording; on camera-subject clips or basic-subject clips whose subject is an uploaded video, they cover the frame over the story background. Screen-only recordings are not supported: using cut-out on them returns 400. Use fullscreen or middle instead.","required":["kind"],"properties":{"kind":{"enum":["cut-out"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"position":{"description":"Combi clips only (required there): which side the cut-out presenter sits on in landscape. Portrait and square stories stack the two instead — `right` puts the presenter at the top, `left` at the bottom. Ignored on camera-subject clips.","enum":["left","right"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.4.position","typeLabel":"enum\u003cstring>"},"style":{"description":"Landscape combi clips only. `regular` (default) places the screen beside the presenter; `perspective` fills most of the canvas with the screen, angled away toward the presenter, who stands in front in the bottom corner on `position`'s side.","enum":["regular","perspective"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.4.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.4","typeLabel":"Cut Out · object"},{"type":"object","title":"Camera Bubble","description":"Floating camera bubble over the screen recording. Combi (all ratios). Position is 9-way. Set `style: full` to put the screen fullscreen behind the bubble.","required":["kind","position","size"],"properties":{"kind":{"enum":["camera-bubble"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right","top","bottom","top-left","top-right","bottom-left","bottom-right","middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5.position","typeLabel":"enum\u003cstring>"},"size":{"enum":["S","M","L"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5.size","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"full\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5.screenFit","typeLabel":"enum\u003cstring>"},"shape":{"description":"Defaults to `circle`, as in the editor's Camera Bubble picker.","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5.shape","typeLabel":"enum\u003cstring>"},"style":{"description":"`regular` (default) keeps the screen layered behind the bubble; `full` puts the screen fullscreen behind the bubble (and honours `screenFit`).","enum":["regular","full"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.5","typeLabel":"Camera Bubble · object"},{"type":"object","title":"Camera Only","description":"Camera fills the frame or sits centered; the screen is hidden. Combi (all ratios).","required":["kind","style"],"properties":{"kind":{"enum":["camera-only"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.6.kind","typeLabel":"enum\u003cstring>"},"style":{"description":"`fullscreen` fills the frame with the camera (optional `punchIn`); `middle` centers a shaped camera (requires `shape`).","enum":["fullscreen","middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.6.style","typeLabel":"enum\u003cstring>"},"punchIn":{"description":"Only allowed when `style: \"fullscreen\"`; `punchIn: true` with `style: \"middle\"` is rejected. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.6.punchIn","typeLabel":"boolean"},"shape":{"description":"Required when `style: \"middle\"`, rejected otherwise. Allowed shapes vary by ratio (no `portrait` in portrait clips, no `square` in square clips).","enum":["circle","square","landscape","portrait"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.6.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.6","typeLabel":"Camera Only · object"},{"type":"object","title":"Screen Only","description":"Screen fills the frame or sits centered; the camera is hidden. Combi (all ratios).","required":["kind","style"],"properties":{"kind":{"enum":["screen-only"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.7.kind","typeLabel":"enum\u003cstring>"},"style":{"description":"`fullscreen` fills the frame with the screen (optional `screenFit`); `middle` centers the screen.","enum":["fullscreen","middle"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.7.style","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"fullscreen\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.7.screenFit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.7","typeLabel":"Screen Only · object"},{"type":"object","title":"Custom","description":"Explicit geometry per slot in artboard pixels (the video's `dimensions`), like a layout arranged by hand in the editor. Valid on any scene type. Read the clip's layouts first: a section that is already custom merges the fields you pass over its current geometry; any other layout needs full `subject` geometry. Custom layouts can't carry `media` and aren't accepted in batch edits.","required":["kind"],"properties":{"kind":{"enum":["custom"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.kind","typeLabel":"enum\u003cstring>"},"presentation":{"type":"object","description":"The camera on combi clips. When omitted on a clip that has a camera and no custom geometry yet, the camera is kept but hidden.","properties":{"corners":{"description":"Corner rounding of a rectangular frame. Defaults to `regular`.","enum":["none","regular","squircle"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Slot size in artboard pixels.","required":["width","height"],"properties":{"height":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.hidden","typeLabel":"boolean"},"order":{"description":"Stacking order; the lower one draws on top: 0 is the front layer and 1 the layer behind it (use only 0 and 1). Defaults to 0 for the subject and 1 for the presentation.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.order","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the slot in artboard pixels.","required":["x","y"],"properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.point","typeLabel":"object"},"shape":{"description":"Frame the layer is drawn in: `none` (default) is the plain rectangle given by `dimensions`; `circle`, `square` and `portrait` are the camera-bubble frames; `cutout` cuts the presenter out of the camera feed; `blob` is a wobbling bubble that grows toward the presenter's hands, and `blob-outline` is the same with a white line around it.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.presentation","typeLabel":"object"},"subject":{"type":"object","description":"The main layer: the screen recording on combi and basic-subject clips, the camera on camera-subject clips. A screen keeps its recording's aspect ratio: `dimensions` are fitted to it around the same centre.","properties":{"corners":{"description":"Corner rounding of a rectangular frame. Defaults to `regular`.","enum":["none","regular","squircle"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.corners","typeLabel":"enum\u003cstring>"},"dimensions":{"type":"object","description":"Slot size in artboard pixels.","required":["width","height"],"properties":{"height":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.hidden","typeLabel":"boolean"},"order":{"description":"Stacking order; the lower one draws on top: 0 is the front layer and 1 the layer behind it (use only 0 and 1). Defaults to 0 for the subject and 1 for the presentation.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.order","typeLabel":"integer"},"point":{"type":"object","description":"Top-left corner of the slot in artboard pixels.","required":["x","y"],"properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.point","typeLabel":"object"},"shape":{"description":"Frame the layer is drawn in: `none` (default) is the plain rectangle given by `dimensions`; `circle`, `square` and `portrait` are the camera-bubble frames; `cutout` cuts the presenter out of the camera feed; `blob` is a wobbling bubble that grows toward the presenter's hands, and `blob-outline` is the same with a white line around it.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8.subject","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.layout.oneOf.8","typeLabel":"Custom · object"}],"uniqueKey":"operations.items.[INDEX].oneOf.22.layout","typeLabel":"Fullscreen · object | Middle · object | Side by Side · object | TV Presenter · object | Cut Out · object | Camera Bubble · object | Camera Only · object | Screen Only · object | Custom · object"},"media":{"oneOf":[{"type":"object","title":"ClipMediaImage","description":"Replace the layout's media content. Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.","required":["type","sourceId"],"properties":{"sourceId":{"description":"Source ID from `POST /v1/sources` (`kind: image`).","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.0.sourceId","typeLabel":"string"},"type":{"enum":["image"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.0.type","typeLabel":"enum\u003cstring>"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.0.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.0","typeLabel":"ClipMediaImage · object"},{"type":"object","title":"ClipMediaVideo","description":"Replace the layout's media content. Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.","required":["type","sourceId"],"properties":{"sourceId":{"description":"Source ID from `POST /v1/sources`.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.1.sourceId","typeLabel":"string"},"type":{"enum":["video"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.1.type","typeLabel":"enum\u003cstring>"},"muted":{"description":"Silence the video's own audio. Defaults to false.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.1.muted","typeLabel":"boolean"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.1.slot","typeLabel":"enum\u003cstring>"},"startTimeMs":{"description":"Where the video starts, in ms of the source itself (its in-point, like the editor's Trim). Defaults to 0. Must be inside the source; a layout longer than what is left of the source loops from this point.","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.1.startTimeMs","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.1","typeLabel":"ClipMediaVideo · object"},{"type":"object","title":"ClipMediaRecording","description":"Replace the layout's media content. Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.","required":["type","startTimeMs"],"properties":{"startTimeMs":{"description":"Where the b-roll starts, in ms on this clip's playback timeline. It plays the recording on for the layout's duration, including any footage cut out in that stretch.","maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.2.startTimeMs","typeLabel":"integer"},"type":{"enum":["recording"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.2.type","typeLabel":"enum\u003cstring>"},"muted":{"description":"Silence the recording's own audio. Defaults to true, since it would repeat the clip's.","type":"boolean","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.2.muted","typeLabel":"boolean"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.2.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.2","typeLabel":"ClipMediaRecording · object"},{"type":"object","title":"ClipMediaMotion","description":"Replace the layout's media content. Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.","required":["type","documentId"],"properties":{"documentId":{"description":"A Tella Motion document of this video's (ffd_…), from `POST /v1/motion/documents`.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.3.documentId","typeLabel":"string"},"type":{"enum":["motion"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.3.type","typeLabel":"enum\u003cstring>"},"slot":{"description":"Which slot the media fills: `screen` (the subject/main frame, the default) or `camera` (the bubble/presentation slot — a media bubble over the recording behind it). A `camera` slot requires a layout that renders the camera (e.g. camera-bubble, side-by-side, tv-presenter).","enum":["screen","camera"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.3.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.media.oneOf.3","typeLabel":"ClipMediaMotion · object"}],"uniqueKey":"operations.items.[INDEX].oneOf.22.media","typeLabel":"ClipMediaImage · object | ClipMediaVideo · object | ClipMediaRecording · object | ClipMediaMotion · object"},"popOut":{"oneOf":[{"type":"object","description":"Switch the camera pop-out on (an object merges over the current settings) or off (null). Omitted leaves it as it is, except that a cut-out layout or `cameraStyle: cutout` drops it. On the base layout this, `cameraStyle` and `crop` are accepted without `layout`.","properties":{"amount":{"description":"How far the frame shrinks below the presenter, as a fraction of the camera slot (0–0.5). Defaults to 0.22.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.0.amount","typeLabel":"number"},"background":{"description":"What fills the frame behind the presenter: `original` keeps the camera feed, `color` paints `color`. Defaults to `original`.","enum":["original","color"],"type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.0.background","typeLabel":"enum\u003cstring>"},"color":{"description":"Frame fill when `background` is `color`, as #RRGGBB or #RRGGBBAA. Defaults to #6366F1.","pattern":"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.0.color","typeLabel":"string"},"outlineColor":{"description":"Outline colour as #RRGGBB or #RRGGBBAA. Defaults to #FFFFFF.","pattern":"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$","type":"string","uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.0.outlineColor","typeLabel":"string"},"outlineWidth":{"description":"Outline around the frame as a fraction of its width (0–0.05); 0 draws none. Defaults to 0.","maximum":0.05,"minimum":0,"type":"number","uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.0.outlineWidth","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"operations.items.[INDEX].oneOf.22.popOut.oneOf.1","typeLabel":"null"}],"uniqueKey":"operations.items.[INDEX].oneOf.22.popOut","typeLabel":"object | null"},"startTimeMs":{"description":"Start time in ms on the clip's playback timeline (cuts applied)","maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"operations.items.[INDEX].oneOf.22.startTimeMs","typeLabel":"integer"},"transitionStyle":{"type":"string","title":"LayoutTransitionStyle","description":"Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.","enum":["spring","hardCut"],"uniqueKey":"operations.items.[INDEX].oneOf.22.transitionStyle","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.22","typeLabel":"object"},{"type":"object","description":"One timeline edit — an add, update, or remove. Operations may target different clips in the same video, and update/remove operations may reference a resource added earlier in the batch by that operation's operationId.","required":["type","operationId","clipId","layoutId"],"properties":{"clipId":{"description":"Clip ID","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.23.clipId","typeLabel":"string"},"layoutId":{"description":"Layout ID, or the operationId of an add operation earlier in this batch.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.23.layoutId","typeLabel":"string"},"operationId":{"description":"Caller-chosen ID used to match this operation to its result. Must be unique within the batch.","example":"sound-1","minLength":1,"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.23.operationId","typeLabel":"string"},"type":{"enum":["remove_layout"],"type":"string","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.23.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.23","typeLabel":"object"}],"uniqueKey":"operations.items.[INDEX]","typeLabel":"object"},"maxItems":200,"minItems":1,"type":"array","isRequired":true,"uniqueKey":"operations","typeLabel":"object[]"}},"required":["operations"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"operations":[{"clipId":"\u003cstring>","durationMs":3000,"operationId":"sound-1","startTimeMs":1000,"type":"add_sound_effect","name":"Whoosh","presetId":"cha-ching","sourceId":"su_abc123","volume":1}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"7bd9d815-b99b-492a-8af0-c76b95265bb9":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"One result per operation, in request order: the created resource ID for adds, the affected resource ID for updates and removes.","properties":{"results":{"items":{"additionalProperties":false,"properties":{"id":{"description":"Created or affected resource ID","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].id","typeLabel":"string"},"operationId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].operationId","typeLabel":"string"},"type":{"enum":["sound_effect","text_overlay","shape_overlay","zoom","blur","highlight","media_overlay","layout"],"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["operationId","type","id"],"type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"revision":{"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"revision","typeLabel":"integer"}},"required":["revision","results"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"id":"\u003cstring>","operationId":"\u003cstring>","type":"sound_effect"}],"revision":4503599627370495}}},"exampleType":"generated"}},"description":"Edits applied","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"generated"},"5dc87ed5-c75e-47bd-af52-71073aaef8a9":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."}}},"exampleType":"examples"}},"description":"The request was malformed or contained invalid parameters.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"c1e79343-4f0a-48d5-b420-fd6f90c19a7b":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."}}},"exampleType":"examples"}},"description":"Authentication is required. Provide a valid API key.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"4368881b-037a-4706-b1c0-b791bf34777f":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."}}},"exampleType":"examples"}},"description":"You don't have permission to access this resource.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"869c927d-9520-413a-9c7c-4702b5585c17":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."}}},"exampleType":"examples"}},"description":"The requested resource was not found.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"1652646c-87a5-450d-9bf5-00c08705b4c2":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"conflict","message":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"conflict","message":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."}}},"exampleType":"examples"}},"description":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"5caad57b-c503-4019-a72a-84846127c070":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."}}},"exampleType":"examples"}},"description":"You have exceeded the rate limit. Please slow down.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a rate-limited request","example":45,"schema":{"minimum":1,"type":"integer"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"45f77d4e-fec3-4a45-8812-3cb6c9553871":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"}}},"exampleType":"examples"}},"description":"An unexpected error occurred","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"47153f1a-1bb1-479f-a4ad-d1963c258b99":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."}}},"exampleType":"examples"}},"description":"The requested operation is not implemented.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"755df577-3f5a-4225-9b5e-78178c3a0c1d":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unavailable","message":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unavailable","message":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."}}},"exampleType":"examples"}},"description":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"}},"security":{"50b4a2b0-24ac-48e4-8bb8-f1c4e76a9c57":{"BearerAuth":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"d2aabac2-b2bc-4b47-a6f4-a26614a56f79":{"description":"Production","url":"https://api.tella.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key obtained from your Tella account settings","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"tella","siteName":"Tella","title":"Apply many video edits - Tella","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Help Center"},{"tab":"Developers"},{"tab":"Changelog"}]},"originalFileLocation":"api-reference/videos/apply-many-video-edits.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tella\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Apply many video edits - Tella\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tella\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Apply+many+video+edits\u0026amp;description=Adds+up+to+200+sound+effects%2C+text+overlays%2C+zooms%2C+blurs%2C+highlights%2C+and+image%2Fvideo+overlays+across+clips+in+one+video.+Operations+run+in+array+order+and+com\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=03368874efe86a68fc2d7cdfc8f02245795d04303d6086c13b5e88ef30b81ecf\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Apply many video edits - Tella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Apply+many+video+edits\u0026amp;description=Adds+up+to+200+sound+effects%2C+text+overlays%2C+zooms%2C+blurs%2C+highlights%2C+and+image%2Fvideo+overlays+across+clips+in+one+video.+Operations+run+in+array+order+and+com\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=03368874efe86a68fc2d7cdfc8f02245795d04303d6086c13b5e88ef30b81ecf\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tella\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8278FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/videos/apply-many-video-edits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.tella.com/#organization\",\"name\":\"Tella\",\"url\":\"https://www.tella.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.tella.com/docs#website\",\"name\":\"Tella\",\"url\":\"https://www.tella.com/docs\",\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits#webpage\",\"url\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits\",\"name\":\"Apply many video edits\",\"description\":\"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.\",\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://www.tella.com/docs/api-reference/account/get-the-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Videos\",\"item\":\"https://www.tella.com/docs/api-reference/videos/list-connected-social-accounts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Apply many video edits\",\"item\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits#apireference\",\"headline\":\"Apply many video edits\",\"name\":\"Apply many video edits\",\"description\":\"Adds up to 200 sound effects, text overlays, zooms, blurs, highlights, and image/video overlays across clips in one video. Operations run in array order and commit as one editor revision. Use this instead of repeated single-add requests.\",\"url\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits\",\"mainEntityOfPage\":{\"@id\":\"https://www.tella.com/docs/api-reference/videos/apply-many-video-edits#webpage\"},\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tella\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tella\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/videos/apply-many-video-edits.md","siteName":"Tella","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/introduction/welcome"}]},{"tab":"Developers","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Set up the Tella MCP server for your AI agent","sidebarTitle":"AI agent setup","href":"/ai-onboarding"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Rate limiting","href":"/rate-limiting"},{"title":"API versioning and deprecation","href":"/versioning"}]},{"group":"Guides","pages":[{"title":"Webhooks","href":"/webhooks"},{"title":"Model Context Protocol (MCP)","href":"/mcp-server"},{"title":"Media library API","href":"/media-library-api"},{"title":"Embed API","href":"/embed-api"}]},{"group":"MCP Tools","pages":[{"group":"Managing videos","pages":[{"title":"Videos","href":"/mcp-tools/videos"},{"title":"Playlists","href":"/mcp-tools/playlists"},{"title":"Tags","href":"/mcp-tools/tags"},{"title":"Agent chats","href":"/mcp-tools/agent-chats"},{"title":"Community skills","href":"/mcp-tools/community-skills"},{"title":"Webhooks","href":"/mcp-tools/webhooks"},{"title":"Social publishing","href":"/mcp-tools/social-publishing"},{"title":"Analytics","href":"/mcp-tools/analytics"},{"title":"Account","href":"/mcp-tools/account"},{"title":"Billing","href":"/mcp-tools/billing"},{"title":"Support","href":"/mcp-tools/support"}]},{"group":"Editing videos","pages":[{"title":"Batch edits","href":"/mcp-tools/batch-edits"},{"title":"Sources","href":"/mcp-tools/sources"},{"title":"Library","href":"/mcp-tools/library"},{"title":"AI media generation","href":"/mcp-tools/ai-media-generation"},{"title":"Auto Capture","href":"/mcp-tools/auto-capture"},{"title":"Backgrounds","href":"/mcp-tools/backgrounds"},{"title":"Chapters","href":"/mcp-tools/chapters"},{"title":"Clips","href":"/mcp-tools/clips"},{"title":"Layouts","href":"/mcp-tools/layouts"},{"title":"Cropping","href":"/mcp-tools/cropping"},{"title":"Background Music","href":"/mcp-tools/background-music"},{"title":"Zooms","href":"/mcp-tools/zooms"},{"title":"Mouse events","href":"/mcp-tools/mouse-events"},{"title":"Key events","href":"/mcp-tools/key-events"},{"title":"Camera faces","href":"/mcp-tools/camera-faces"},{"title":"Blurs and highlights","href":"/mcp-tools/blurs-and-highlights"},{"title":"Overlays","href":"/mcp-tools/overlays"},{"title":"Text overlays","href":"/mcp-tools/text-overlays"},{"title":"Shape overlays","href":"/mcp-tools/shape-overlays"},{"title":"Sound effects","href":"/mcp-tools/sound-effects"}]},{"group":"Tella Motion","pages":[{"title":"Tella Motion","href":"/mcp-tools/motion"},{"title":"Tella Motion commands","href":"/mcp-tools/motion-commands"},{"title":"Tella Motion properties, easing and fonts","href":"/mcp-tools/motion-values"},{"title":"Tella Motion effects","href":"/mcp-tools/motion-effects"}]}]},{"group":"API Reference","pages":[{"group":"Account","pages":[{"title":"Get the account","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/account","href":"/api-reference/account/get-the-account"}]},{"group":"Agent chats","pages":[{"title":"List a video's agent chats","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/agent-chats","href":"/api-reference/agent-chats/list-a-videos-agent-chats"},{"title":"Start an agent chat","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/agent-chats","href":"/api-reference/agent-chats/start-an-agent-chat"}]},{"group":"Analytics","pages":[{"title":"Get workspace analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics","href":"/api-reference/analytics/get-workspace-analytics"},{"title":"List workspace views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics/views","href":"/api-reference/analytics/list-workspace-views"},{"title":"List a playlist's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}/views","href":"/api-reference/analytics/list-a-playlists-views"},{"title":"Get video analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/analytics","href":"/api-reference/analytics/get-video-analytics"},{"title":"List a video's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/views","href":"/api-reference/analytics/list-a-videos-views"}]},{"group":"Auto Capture","pages":[{"title":"Report an Auto Capture take","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auto-captures/{sourceId}/reports","href":"/api-reference/auto-capture/report-an-auto-capture-take"}]},{"group":"Backgrounds","pages":[{"title":"List available backgrounds","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/backgrounds","href":"/api-reference/backgrounds/list-available-backgrounds"}]},{"group":"Library","pages":[{"title":"List library items","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library","href":"/api-reference/library/list-library-items"},{"title":"Add a source to the library","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library","href":"/api-reference/library/add-a-source-to-the-library"},{"title":"Split an image into layers","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/decompositions","href":"/api-reference/library/split-an-image-into-layers"},{"title":"Generate media with AI","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/generations","href":"/api-reference/library/generate-media-with-ai"},{"title":"Get a generation's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/generations/{id}","href":"/api-reference/library/get-a-generations-status"},{"title":"Import media from a URL","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/imports","href":"/api-reference/library/import-media-from-a-url"},{"title":"Get an import's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/imports/{id}","href":"/api-reference/library/get-an-imports-status"},{"title":"Capture a web page or social post","deprecated":true,"version":null,"openapi":"/openapi.json post /v1/library/screenshots","href":"/api-reference/library/capture-a-web-page-or-social-post"},{"title":"Remove a library item","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/library/{id}","href":"/api-reference/library/remove-a-library-item"}]},{"group":"Tella Motion","pages":[{"title":"Add a Tella Motion clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/clips","href":"/api-reference/tella-motion/add-a-tella-motion-clip"},{"title":"List Tella Motion documents","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents","href":"/api-reference/tella-motion/list-tella-motion-documents"},{"title":"Create a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents","href":"/api-reference/tella-motion/create-a-tella-motion-document"},{"title":"Summarize a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}","href":"/api-reference/tella-motion/summarize-a-tella-motion-document"},{"title":"Edit a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/commands","href":"/api-reference/tella-motion/edit-a-tella-motion-document"},{"title":"Inspect a composition","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/compositions/{compositionId}","href":"/api-reference/tella-motion/inspect-a-composition"},{"title":"Download a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/download","href":"/api-reference/tella-motion/download-a-tella-motion-document"},{"title":"Duplicate a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/duplicate","href":"/api-reference/tella-motion/duplicate-a-tella-motion-document"},{"title":"List a document's media","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/media","href":"/api-reference/tella-motion/list-a-documents-media"},{"title":"Inspect a node's properties","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes","href":"/api-reference/tella-motion/inspect-a-nodes-properties"},{"title":"Get a node's stored fields","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes/raw","href":"/api-reference/tella-motion/get-a-nodes-stored-fields"},{"title":"Get a frame or preview of a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/thumbnail","href":"/api-reference/tella-motion/get-a-frame-or-preview-of-a-tella-motion-document"},{"title":"List Tella Motion effects","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/effects","href":"/api-reference/tella-motion/list-tella-motion-effects"},{"title":"List Tella Motion fonts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/fonts","href":"/api-reference/tella-motion/list-tella-motion-fonts"},{"title":"Get a Tella Motion JSON schema","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/schema","href":"/api-reference/tella-motion/get-a-tella-motion-json-schema"}]},{"group":"Playlist Groups","pages":[{"title":"List playlist groups","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlist-groups","href":"/api-reference/playlist-groups/list-playlist-groups"},{"title":"Create a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlist-groups","href":"/api-reference/playlist-groups/create-a-playlist-group"},{"title":"Delete a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/delete-a-playlist-group"},{"title":"Rename or reorder a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/rename-or-reorder-a-playlist-group"}]},{"group":"Playlists","pages":[{"title":"List all playlists","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists","href":"/api-reference/playlists/list-all-playlists"},{"title":"Create a new playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists","href":"/api-reference/playlists/create-a-new-playlist"},{"title":"Get playlist details","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}","href":"/api-reference/playlists/get-playlist-details"},{"title":"Delete a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}","href":"/api-reference/playlists/delete-a-playlist"},{"title":"Update a playlist","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlists/{id}","href":"/api-reference/playlists/update-a-playlist"},{"title":"Add a video to a playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists/{id}/videos","href":"/api-reference/playlists/add-a-video-to-a-playlist"},{"title":"Remove a video from a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}/videos/{videoId}","href":"/api-reference/playlists/remove-a-video-from-a-playlist"}]},{"group":"Videos","pages":[{"title":"List connected social accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/social-accounts","href":"/api-reference/videos/list-connected-social-accounts"},{"title":"List subtitle presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/subtitle-presets","href":"/api-reference/videos/list-subtitle-presets"},{"title":"Save a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subtitle-presets","href":"/api-reference/videos/save-a-subtitle-preset"},{"title":"List all videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos","href":"/api-reference/videos/list-all-videos"},{"title":"Create a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video"},{"title":"Search videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/search","href":"/api-reference/videos/search-videos"},{"title":"Get video information","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}","href":"/api-reference/videos/get-video-information"},{"title":"Delete a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}","href":"/api-reference/videos/delete-a-video"},{"title":"Update a video","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}","href":"/api-reference/videos/update-a-video"},{"title":"Set background music","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/background-music","href":"/api-reference/videos/set-background-music"},{"title":"Remove background music","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/background-music","href":"/api-reference/videos/remove-background-music"},{"title":"Get the beats of the background music","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/background-music/beats","href":"/api-reference/videos/get-the-beats-of-the-background-music"},{"title":"Download video captions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/captions","href":"/api-reference/videos/download-video-captions"},{"title":"Get video chapters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/chapters","href":"/api-reference/videos/get-video-chapters"},{"title":"Replace video chapters","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/chapters","href":"/api-reference/videos/replace-video-chapters"},{"title":"Add a collaborator to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/collaborators","href":"/api-reference/videos/add-a-collaborator-to-a-video"},{"title":"Generate a document from a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/documents","href":"/api-reference/videos/generate-a-document-from-a-video"},{"title":"Get a generated document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/documents/{documentId}","href":"/api-reference/videos/get-a-generated-document"},{"title":"Duplicate a video","description":"Creates a copy of the specified video. Optionally specify a new name for the duplicate.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/duplicate","href":"/api-reference/videos/duplicate-a-video"},{"title":"Apply many video edits","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/edits","href":"/api-reference/videos/apply-many-video-edits"},{"title":"List video exports","description":"Lists all exports for the specified video with their current status, progress, and download URL when ready. Requires edit access to the video, or viewer access to a video with downloads (or raw downloads) enabled.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports","href":"/api-reference/videos/list-video-exports"},{"title":"Start a video export","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/exports","href":"/api-reference/videos/start-a-video-export"},{"title":"Get video export status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports/{exportId}","href":"/api-reference/videos/get-video-export-status"},{"title":"Get a live preview link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/live-preview","href":"/api-reference/videos/get-a-live-preview-link"},{"title":"List social publications","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/publish","href":"/api-reference/videos/list-social-publications"},{"title":"Publish a video to social media","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/publish","href":"/api-reference/videos/publish-a-video-to-social-media"},{"title":"Cancel a scheduled publish","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/publish","href":"/api-reference/videos/cancel-a-scheduled-publish"},{"title":"Get a recording link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/recording-link","href":"/api-reference/videos/get-a-recording-link"},{"title":"Get a video storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/storyboard","href":"/api-reference/videos/get-a-video-storyboard"},{"title":"Apply a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/subtitle-preset","href":"/api-reference/videos/apply-a-subtitle-preset"},{"title":"Get a video thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/thumbnail","href":"/api-reference/videos/get-a-video-thumbnail-or-animated-preview"},{"title":"Set a video's thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/thumbnail","href":"/api-reference/videos/set-a-videos-thumbnail"},{"title":"Remove a video's custom thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/thumbnail","href":"/api-reference/videos/remove-a-videos-custom-thumbnail"},{"title":"Get a video's timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/timeline","href":"/api-reference/videos/get-a-videos-timeline"}]},{"group":"Sources","pages":[{"title":"Create a source upload (video, audio, image, or LUT)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sources","href":"/api-reference/sources/create-a-source-upload-video-audio-image-or-lut"},{"title":"Get a source's processing status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}","href":"/api-reference/sources/get-a-sources-processing-status"},{"title":"Get the beats of an audio or video source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/beats","href":"/api-reference/sources/get-the-beats-of-an-audio-or-video-source"},{"title":"Get a streaming upload storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/storyboard","href":"/api-reference/sources/get-a-streaming-upload-storyboard"},{"title":"Get a thumbnail of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/thumbnail","href":"/api-reference/sources/get-a-thumbnail-of-a-source-on-no-clip"},{"title":"Get the transcript of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/transcript","href":"/api-reference/sources/get-the-transcript-of-a-source-on-no-clip"},{"title":"Get the audio waveform JSON for a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/waveform","href":"/api-reference/sources/get-the-audio-waveform-json-for-a-source-on-no-clip"}]},{"group":"Tags","pages":[{"title":"List all tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/tags","href":"/api-reference/tags/list-all-tags"},{"title":"Create a new tag","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tags","href":"/api-reference/tags/create-a-new-tag"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/tags/{id}","href":"/api-reference/tags/delete-a-tag"},{"title":"Update a tag","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/tags/{id}","href":"/api-reference/tags/update-a-tag"},{"title":"List a video's tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/tags","href":"/api-reference/tags/list-a-videos-tags"},{"title":"Add a tag to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/tags","href":"/api-reference/tags/add-a-tag-to-a-video"},{"title":"Remove a tag from a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/tags/{tagId}","href":"/api-reference/tags/remove-a-tag-from-a-video"}]},{"group":"Clips","pages":[{"title":"List text presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/text-presets","href":"/api-reference/clips/list-text-presets"},{"title":"Save a text preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-presets","href":"/api-reference/clips/save-a-text-preset"},{"title":"Delete a text preset","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/text-presets/{presetId}","href":"/api-reference/clips/delete-a-text-preset"},{"title":"List clips for a video","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips","href":"/api-reference/clips/list-clips-for-a-video"},{"title":"Add a clip from an uploaded source","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips","href":"/api-reference/clips/add-a-clip-from-an-uploaded-source"},{"title":"Get a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/get-a-clip"},{"title":"Delete a clip","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/delete-a-clip"},{"title":"Update a clip","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/update-a-clip"},{"title":"Get audio levels in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/audio-levels","href":"/api-reference/clips/get-audio-levels-in-a-clip"},{"title":"Auto-crop a clip's screen recording","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/auto-crop","href":"/api-reference/clips/auto-crop-a-clips-screen-recording"},{"title":"List blurs on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/list-blurs-on-a-clip"},{"title":"Add a blur to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/add-a-blur-to-a-clip"},{"title":"Remove a blur","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/remove-a-blur"},{"title":"Update a blur","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/update-a-blur"},{"title":"List faces in a clip's camera","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/camera-faces","href":"/api-reference/clips/list-faces-in-a-clips-camera"},{"title":"Cut one or more time ranges from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut","href":"/api-reference/clips/cut-one-or-more-time-ranges-from-a-clip"},{"title":"Cut clip ranges by transcript word indices","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut-by-transcript","href":"/api-reference/clips/cut-clip-ranges-by-transcript-word-indices"},{"title":"Duplicate a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/duplicate","href":"/api-reference/clips/duplicate-a-clip"},{"title":"Get clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/get-clip-color-filters"},{"title":"Set clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/set-clip-color-filters"},{"title":"List highlights on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/list-highlights-on-a-clip"},{"title":"Add a highlight to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/add-a-highlight-to-a-clip"},{"title":"Remove a highlight","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/remove-a-highlight"},{"title":"Update a highlight","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/update-a-highlight"},{"title":"List key presses on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/key-events","href":"/api-reference/clips/list-key-presses-on-a-clip"},{"title":"List layouts on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/list-layouts-on-a-clip"},{"title":"Add a layout to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/add-a-layout-to-a-clip"},{"title":"Remove a layout","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/remove-a-layout"},{"title":"Update a layout","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/update-a-layout"},{"title":"List mouse events on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/mouse-events","href":"/api-reference/clips/list-mouse-events-on-a-clip"},{"title":"List overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/list-overlays-on-a-clip"},{"title":"Add an overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/add-an-overlay-to-a-clip"},{"title":"Remove an overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/remove-an-overlay"},{"title":"Update an overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/update-an-overlay"},{"title":"Remove filler words from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-fillers","href":"/api-reference/clips/remove-filler-words-from-a-clip"},{"title":"Remove silences from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-silences","href":"/api-reference/clips/remove-silences-from-a-clip"},{"title":"Reorder a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/reorder","href":"/api-reference/clips/reorder-a-clip"},{"title":"List shape overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/list-shape-overlays-on-a-clip"},{"title":"Add a shape overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/add-a-shape-overlay-to-a-clip"},{"title":"Remove a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/remove-a-shape-overlay"},{"title":"Update a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/update-a-shape-overlay"},{"title":"Get silent ranges in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/silences","href":"/api-reference/clips/get-silent-ranges-in-a-clip"},{"title":"List sound effects on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/list-sound-effects-on-a-clip"},{"title":"Add a sound effect to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/add-a-sound-effect-to-a-clip"},{"title":"Remove a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/remove-a-sound-effect"},{"title":"Update a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/update-a-sound-effect"},{"title":"List sources for a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources","href":"/api-reference/clips/list-sources-for-a-clip"},{"title":"Get a source thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/thumbnail","href":"/api-reference/clips/get-a-source-thumbnail-or-animated-preview"},{"title":"Get the audio waveform JSON for a source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/waveform","href":"/api-reference/clips/get-the-audio-waveform-json-for-a-source"},{"title":"Split a clip in two","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/split","href":"/api-reference/clips/split-a-clip-in-two"},{"title":"Get a clip storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/storyboard","href":"/api-reference/clips/get-a-clip-storyboard"},{"title":"List text overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/list-text-overlays-on-a-clip"},{"title":"Add a text overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/add-a-text-overlay-to-a-clip"},{"title":"Remove a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/remove-a-text-overlay"},{"title":"Update a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/update-a-text-overlay"},{"title":"Get a clip thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/thumbnail","href":"/api-reference/clips/get-a-clip-thumbnail-or-animated-preview"},{"title":"Get clip transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/transcript","href":"/api-reference/clips/get-clip-transcript"},{"title":"Correct transcript words","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/transcript/words","href":"/api-reference/clips/correct-transcript-words"},{"title":"List zooms on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/list-zooms-on-a-clip"},{"title":"Add a zoom to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/add-a-zoom-to-a-clip"},{"title":"Auto-generate zooms from mouse activity","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms/auto","href":"/api-reference/clips/auto-generate-zooms-from-mouse-activity"},{"title":"Remove a zoom","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/remove-a-zoom"},{"title":"Update a zoom","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/update-a-zoom"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Get endpoint signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{id}/secret","href":"/api-reference/webhooks/get-endpoint-signing-secret"},{"title":"List recent webhook messages","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages","href":"/api-reference/webhooks/list-recent-webhook-messages"},{"title":"Get a specific webhook message","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages/{id}","href":"/api-reference/webhooks/get-a-specific-webhook-message"}]}]},{"group":"Webhooks","pages":[{"group":"Videos","pages":[{"title":"Document generated","version":null,"deprecated":null,"openapi":"/webhooks.json webhook document.generated","href":"/api-reference/videos/document-generated"},{"title":"Export ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook export.ready","href":"/api-reference/videos/export-ready"},{"title":"Transcript ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook transcript.ready","href":"/api-reference/videos/transcript-ready"},{"title":"Video created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.created","href":"/api-reference/videos/video-created"},{"title":"View milestone reached","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.milestone","href":"/api-reference/videos/view-milestone-reached"},{"title":"Video viewed","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.viewed","href":"/api-reference/videos/video-viewed"}]},{"group":"Playlists","pages":[{"title":"Playlist created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.created","href":"/api-reference/playlists/playlist-created"},{"title":"Video added to playlist","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.video_added","href":"/api-reference/playlists/video-added-to-playlist"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Apply many video edits - Tella","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}