{
"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."
}
Add a layout to a clip
Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.
{
"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
Video identifier
Example:
"vid_abc123def456"
clipId
string
required
Clip identifier
Example:
"cl_xyz789ghi012"
Body
application/json
Add a layout to a clip
cameraStyle
enum<string> | null
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).
Available options:
none,
circle,
square,
portrait,
cutout,
blob,
blob-outline
crop
object | null
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.
Hide child attributes
crop.bottom
number
required
Pixels of the screen recording removed from its bottom edge
Required range: x >= 0
crop.left
number
required
Pixels of the screen recording removed from its left edge
Required range: x >= 0
crop.right
number
required
Pixels of the screen recording removed from its right edge
Required range: x >= 0
crop.top
number
required
Pixels of the screen recording removed from its top edge
Required range: x >= 0
durationMs
integer
Optional. Provide together with startTimeMs for a time-ranged layout. Minimum 200ms.
Required range: 200 <= x <= 9007199254740991
layout
Fullscreen · object
Layout shape. May be omitted when media is provided to use the default full-frame B-roll layout.
Fullscreen
Middle
Side by Side
TV Presenter
Cut Out
Camera Bubble
Camera Only
Screen Only
Custom
Hide child attributes
layout.kind
enum<string>
required
Available options:
fullscreen
layout.screenFit
enum<string>
Only honoured for basic-subject clips (Tella renders the screen fullscreen). Defaults to cover.
Available options:
cover,
letterbox
layout.style
enum<string>
regular (default) is plain fullscreen; stretch punches in to 1.15x. On basic-subject clips stretch needs uploaded footage (not a screen recording).
Available options:
regular,
stretch
media
ClipMediaImage · object
Optional media content to show during this layout. Only valid on time-ranged layouts.
ClipMediaImage
ClipMediaVideo
ClipMediaRecording
ClipMediaMotion
Hide child attributes
media.sourceId
string
required
Source ID from POST /v1/sources (kind: image).
Minimum string length: 1
media.type
enum<string>
required
Available options:
image
media.slot
enum<string>
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).
Available options:
screen,
camera
popOut
object | null
Pop the presenter out of the camera frame. Omitted or null leaves it off.
Hide child attributes
popOut.amount
number
How far the frame shrinks below the presenter, as a fraction of the camera slot (0–0.5). Defaults to 0.22.
Required range: 0 <= x <= 0.5
popOut.background
enum<string>
What fills the frame behind the presenter: original keeps the camera feed, color paints color. Defaults to original.
Available options:
original,
color
popOut.color
string
Frame fill when background is color, as #RRGGBB or #RRGGBBAA. Defaults to #6366F1.
Pattern: ^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$
popOut.outlineColor
string
Outline colour as #RRGGBB or #RRGGBBAA. Defaults to #FFFFFF.
Pattern: ^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$
popOut.outlineWidth
number
Outline around the frame as a fraction of its width (0–0.05); 0 draws none. Defaults to 0.
Required range: 0 <= x <= 0.05
startTimeMs
integer
Optional. Provide together with durationMs for a time-ranged layout. In ms on the clip's playback timeline (cuts applied).
Required range: 0 <= x <= 9007199254740991
transitionStyle
enum<string>
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.
Available options:
spring,
hardCut
Response
OK
A layout on a clip
layout
object
required
A layout attached to a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the layout stays anchored to the footage, so it doesn't drift when cuts change later.
Hide child attributes
layout.id
string
required
Layout ID
layout.media
object[]
required
B-roll media on this layout — one entry per filled slot (screen and/or camera). Empty on the base layout and on layouts whose underlying section carries no media. Each entry's slot says which slot it fills.
Hide child attributes
layout.media.type
enum<string>
required
Available options:
image,
video,
motion
layout.media.documentId
string
The Tella Motion document (ffd_…) that motion media plays.
layout.media.height
integer | null
Image height in pixels (image media only).
Required range: -9007199254740991 <= x <= 9007199254740991
layout.media.imageUrl
string | null
Hosted image URL, for image media. Read-only: not accepted as input — pass sourceId instead.
layout.media.muted
boolean | null
True when video media plays with its own audio silenced.
layout.media.slot
enum<string>
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).
Available options:
screen,
camera
layout.media.sourceId
string | null
Source ID the media was created from. Absent for image media added in the editor.
layout.media.startTimeMs
number | null
Video media only: where it starts in its source, in ms. Absent when it plays from the start.
layout.media.width
integer | null
Image width in pixels (image media only).
Required range: -9007199254740991 <= x <= 9007199254740991
layout.cameraStyle
enum<string>
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), blob or blob-outline. It shapes the camera bubble and the pop-out frame. Absent when the layout's own shape applies; custom layouts report it as presentation.shape instead.
Available options:
none,
circle,
square,
portrait,
cutout,
blob,
blob-outline
layout.crop
object | null
The crop of the clip's screen recording while this layout shows — the layout's own crop, else the clip's. Absent when the recording is uncropped.
Hide child attributes
layout.crop.bottom
number
required
Pixels of the screen recording removed from its bottom edge
Required range: x >= 0
layout.crop.left
number
required
Pixels of the screen recording removed from its left edge
Required range: x >= 0
layout.crop.right
number
required
Pixels of the screen recording removed from its right edge
Required range: x >= 0
layout.crop.top
number
required
Pixels of the screen recording removed from its top edge
Required range: x >= 0
layout.durationMs
number | null
Layout duration in ms. Omitted for clip-spanning layouts.
Required range: x >= 0
Example:
5000
layout.followsBase
boolean
True when this layout follows the clip's base layout: updating the base layout changes it too, so it needs no update of its own. False when it has its own layout. Absent on the base layout itself.
layout.layout
Fullscreen · object
Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as kind: custom. Null only for internal layouts outside the public vocabulary.
Fullscreen
Middle
Side by Side
TV Presenter
Cut Out
Camera Bubble
Camera Only
Screen Only
Custom
Hide child attributes
layout.layout.kind
enum<string>
required
Available options:
fullscreen
layout.layout.screenFit
enum<string>
Only honoured for basic-subject clips (Tella renders the screen fullscreen). Defaults to cover.
Available options:
cover,
letterbox
layout.layout.style
enum<string>
regular (default) is plain fullscreen; stretch punches in to 1.15x. On basic-subject clips stretch needs uploaded footage (not a screen recording).
Available options:
regular,
stretch
layout.popOut
object | null
The camera's pop-out while this layout shows. Absent when it is off.
Hide child attributes
layout.popOut.amount
number
How far the frame shrinks below the presenter, as a fraction of the camera slot (0–0.5). Defaults to 0.22.
Required range: 0 <= x <= 0.5
layout.popOut.background
enum<string>
What fills the frame behind the presenter: original keeps the camera feed, color paints color. Defaults to original.
Available options:
original,
color
layout.popOut.color
string
Frame fill when background is color, as #RRGGBB or #RRGGBBAA. Defaults to #6366F1.
Pattern: ^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$
layout.popOut.outlineColor
string
Outline colour as #RRGGBB or #RRGGBBAA. Defaults to #FFFFFF.
Pattern: ^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$
layout.popOut.outlineWidth
number
Outline around the frame as a fraction of its width (0–0.05); 0 draws none. Defaults to 0.
Required range: 0 <= x <= 0.05
layout.startTimeMs
number | null
Layout start time in ms on the clip's playback timeline (cuts applied). Omitted for clip-spanning layouts.
Required range: x >= 0
Example:
0
layout.transitionStyle
enum<string> | null
Transition into this layout. Omitted on the base layout, or when the section uses an internal style not exposed via the public API.
Available options:
spring,
hardCut
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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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/clips/add-a-layout-to-a-clip","slug":"/api-reference/clips/add-a-layout-to-a-clip","pageMetadata":{"title":"Add a layout to a clip","description":"Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/add-a-layout-to-a-clip","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 a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.\"\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":"Add a layout to a clip","description":"Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/add-a-layout-to-a-clip","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 a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.","operationId":"addClipLayout","parameters":["c74dab8e-482d-4fde-8b84-256fd36d5814","92cfd10c-36e2-4b04-ad38-66d312e404a6"],"requestBody":"f02f1eb1-1323-423f-ba37-642252327bf2","responses":{"200":"eb991e6e-38f4-47ac-81b7-845cb1a9720d","400":"6da9a3af-5616-425c-bc83-c2ba741cb394","401":"513bf1e0-be89-4a3d-aad3-26269db46aa7","403":"7c98c13d-923b-4821-91af-85b2a7e89dc2","404":"4f7cb954-44de-426e-9da8-1073c20edb8c","409":"00aa34cc-cf4a-4267-9dda-b787782cc9ce","429":"61089d4e-c2d3-46e4-b07a-abc67e310baa","500":"1d0c65fd-d083-417b-95f8-9c51323b2ec1","501":"2c51ecc2-b13c-46c5-bed2-5ab99c254da5","503":"b19d7432-fe1d-4bfb-b7e3-ff4b4a78b329"},"security":["391dbe7e-1e55-4652-838c-14f99878a063"],"summary":"Add a layout to a clip","tags":["Clips"],"method":"post","type":"path","servers":["d2aabac2-b2bc-4b47-a6f4-a26614a56f79"],"path":"/v1/videos/{id}/clips/{clipId}/layouts","baseUrlOptions":["https://api.tella.com"],"title":"Add a layout to a clip","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.crop.oneOf.0.bottom":1,"body.crop.oneOf.0.left":1,"body.crop.oneOf.0.right":1,"body.crop.oneOf.0.top":1,"body.durationMs":4503599627370596,"body.layout.oneOf.0.kind":"fullscreen","body.media.oneOf.0.sourceId":"\u003cstring>","body.media.oneOf.0.type":"image","body.popOut.oneOf.0.amount":0.25,"body.popOut.oneOf.0.color":"\u003cstring>","body.popOut.oneOf.0.outlineColor":"\u003cstring>","body.popOut.oneOf.0.outlineWidth":0.025,"body.startTimeMs":4503599627370495}],"urlDisplay":"full"},"dependencies":{"parameters":{"c74dab8e-482d-4fde-8b84-256fd36d5814":{"description":"Video identifier","in":"path","name":"id","required":true,"schema":{"description":"Video identifier","example":"vid_abc123def456","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"92cfd10c-36e2-4b04-ad38-66d312e404a6":{"description":"Clip identifier","in":"path","name":"clipId","required":true,"schema":{"description":"Clip identifier","example":"cl_xyz789ghi012","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Add a layout to a clip","properties":{"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":"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":"cameraStyle.oneOf.1","typeLabel":"null"}],"uniqueKey":"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":"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":"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":"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":"crop.oneOf.0.top","typeLabel":"number"}},"uniqueKey":"crop.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"crop.oneOf.1","typeLabel":"null"}],"uniqueKey":"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":"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":"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":"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":"layout.oneOf.0.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"layout.oneOf.1.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"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":"layout.oneOf.2.style","typeLabel":"enum\u003cstring>"},"size":{"description":"Camera size. Required when `style: \"overlap\"`; ignored otherwise.","enum":["S","M","L"],"type":"string","uniqueKey":"layout.oneOf.2.size","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"layout.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right"],"type":"string","isRequired":true,"uniqueKey":"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":"layout.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"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":"layout.oneOf.4.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"layout.oneOf.5.position","typeLabel":"enum\u003cstring>"},"size":{"enum":["S","M","L"],"type":"string","isRequired":true,"uniqueKey":"layout.oneOf.5.size","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"full\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"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":"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":"layout.oneOf.5.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"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":"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":"layout.oneOf.6.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"layout.oneOf.7.style","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"fullscreen\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"layout.oneOf.7.screenFit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"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":"layout.oneOf.8.presentation.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"layout.oneOf.8.presentation.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.oneOf.8.presentation.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"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":"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":"layout.oneOf.8.presentation.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"layout.oneOf.8.presentation.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"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":"layout.oneOf.8.presentation.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"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":"layout.oneOf.8.subject.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"layout.oneOf.8.subject.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.oneOf.8.subject.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"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":"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":"layout.oneOf.8.subject.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"layout.oneOf.8.subject.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"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":"layout.oneOf.8.subject.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.oneOf.8.subject","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"layout.oneOf.8","typeLabel":"Custom · object"}],"uniqueKey":"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":"media.oneOf.0.sourceId","typeLabel":"string"},"type":{"enum":["image"],"type":"string","isRequired":true,"uniqueKey":"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":"media.oneOf.0.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"media.oneOf.1.sourceId","typeLabel":"string"},"type":{"enum":["video"],"type":"string","isRequired":true,"uniqueKey":"media.oneOf.1.type","typeLabel":"enum\u003cstring>"},"muted":{"description":"Silence the video's own audio. Defaults to false.","type":"boolean","uniqueKey":"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":"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":"media.oneOf.1.startTimeMs","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"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":"media.oneOf.2.startTimeMs","typeLabel":"integer"},"type":{"enum":["recording"],"type":"string","isRequired":true,"uniqueKey":"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":"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":"media.oneOf.2.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"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":"media.oneOf.3.documentId","typeLabel":"string"},"type":{"enum":["motion"],"type":"string","isRequired":true,"uniqueKey":"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":"media.oneOf.3.slot","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"media.oneOf.3","typeLabel":"ClipMediaMotion · object"}],"uniqueKey":"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":"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":"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":"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":"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":"popOut.oneOf.0.outlineWidth","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"popOut.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"popOut.oneOf.1","typeLabel":"null"}],"uniqueKey":"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":"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":"transitionStyle","typeLabel":"enum\u003cstring>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"crop":{"bottom":1,"left":1,"right":1,"top":1},"durationMs":4503599627370596,"layout":{"kind":"fullscreen"},"media":{"sourceId":"\u003cstring>","type":"image"},"popOut":{"amount":0.25,"color":"\u003cstring>","outlineColor":"\u003cstring>","outlineWidth":0.025},"startTimeMs":4503599627370495}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"eb991e6e-38f4-47ac-81b7-845cb1a9720d":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"A layout on a clip","properties":{"layout":{"additionalProperties":false,"description":"A layout attached to a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the layout stays anchored to the footage, so it doesn't drift when cuts change later.","properties":{"id":{"description":"Layout ID","type":"string","isRequired":true,"uniqueKey":"layout.id","typeLabel":"string"},"media":{"description":"B-roll media on this layout — one entry per filled slot (screen and/or camera). Empty on the base layout and on layouts whose underlying section carries no media. Each entry's `slot` says which slot it fills.","items":{"additionalProperties":false,"description":"Media on a layout, as returned in responses.","properties":{"type":{"enum":["image","video","motion"],"type":"string","isRequired":true,"uniqueKey":"layout.media.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"documentId":{"description":"The Tella Motion document (ffd_…) that `motion` media plays.","type":"string","uniqueKey":"layout.media.items.[INDEX].documentId","typeLabel":"string"},"height":{"oneOf":[{"description":"Image height in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"layout.media.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"description":"Image height in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"layout.media.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.media.items.[INDEX].height","typeLabel":"integer | null"},"imageUrl":{"oneOf":[{"description":"Hosted image URL, for image media. Read-only: not accepted as input — pass `sourceId` instead.","type":"string","uniqueKey":"layout.media.items.[INDEX].imageUrl.oneOf.0","typeLabel":"string"},{"description":"Hosted image URL, for image media. Read-only: not accepted as input — pass `sourceId` instead.","type":"null","uniqueKey":"layout.media.items.[INDEX].imageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.media.items.[INDEX].imageUrl","typeLabel":"string | null"},"muted":{"oneOf":[{"description":"True when video media plays with its own audio silenced.","type":"boolean","uniqueKey":"layout.media.items.[INDEX].muted.oneOf.0","typeLabel":"boolean"},{"description":"True when video media plays with its own audio silenced.","type":"null","uniqueKey":"layout.media.items.[INDEX].muted.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.media.items.[INDEX].muted","typeLabel":"boolean | null"},"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":"layout.media.items.[INDEX].slot","typeLabel":"enum\u003cstring>"},"sourceId":{"oneOf":[{"description":"Source ID the media was created from. Absent for image media added in the editor.","type":"string","uniqueKey":"layout.media.items.[INDEX].sourceId.oneOf.0","typeLabel":"string"},{"description":"Source ID the media was created from. Absent for image media added in the editor.","type":"null","uniqueKey":"layout.media.items.[INDEX].sourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.media.items.[INDEX].sourceId","typeLabel":"string | null"},"startTimeMs":{"oneOf":[{"description":"Video media only: where it starts in its source, in ms. Absent when it plays from the start.","type":"number","uniqueKey":"layout.media.items.[INDEX].startTimeMs.oneOf.0","typeLabel":"number"},{"description":"Video media only: where it starts in its source, in ms. Absent when it plays from the start.","type":"null","uniqueKey":"layout.media.items.[INDEX].startTimeMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.media.items.[INDEX].startTimeMs","typeLabel":"number | null"},"width":{"oneOf":[{"description":"Image width in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","uniqueKey":"layout.media.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"description":"Image width in pixels (image media only).","maximum":9007199254740991,"minimum":-9007199254740991,"type":"null","uniqueKey":"layout.media.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.media.items.[INDEX].width","typeLabel":"integer | null"}},"required":["type"],"type":"object","uniqueKey":"layout.media.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"layout.media","typeLabel":"object[]"},"cameraStyle":{"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), `blob` or `blob-outline`. It shapes the camera bubble and the pop-out frame. Absent when the layout's own shape applies; custom layouts report it as `presentation.shape` instead.","enum":["none","circle","square","portrait","cutout","blob","blob-outline"],"type":"string","uniqueKey":"layout.cameraStyle","typeLabel":"enum\u003cstring>"},"crop":{"oneOf":[{"type":"object","description":"The crop of the clip's screen recording while this layout shows — the layout's own crop, else the clip's. Absent when the recording is uncropped.","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":"layout.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":"layout.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":"layout.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":"layout.crop.oneOf.0.top","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.crop.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"layout.crop.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.crop","typeLabel":"object | null"},"durationMs":{"oneOf":[{"description":"Layout duration in ms. Omitted for clip-spanning layouts.","example":5000,"minimum":0,"type":"number","uniqueKey":"layout.durationMs.oneOf.0","typeLabel":"number"},{"description":"Layout duration in ms. Omitted for clip-spanning layouts.","example":5000,"minimum":0,"type":"null","uniqueKey":"layout.durationMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.durationMs","typeLabel":"number | null"},"followsBase":{"description":"True when this layout follows the clip's base layout: updating the `base` layout changes it too, so it needs no update of its own. False when it has its own layout. Absent on the base layout itself.","type":"boolean","uniqueKey":"layout.followsBase","typeLabel":"boolean"},"layout":{"oneOf":[{"type":"object","title":"Fullscreen","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["fullscreen"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.0.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.0","typeLabel":"Fullscreen · object"},{"type":"object","title":"Middle","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["middle"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.layout.oneOf.1.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.1","typeLabel":"Middle · object"},{"type":"object","title":"Side by Side","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","position","style"],"properties":{"kind":{"enum":["side-by-side"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.2.style","typeLabel":"enum\u003cstring>"},"size":{"description":"Camera size. Required when `style: \"overlap\"`; ignored otherwise.","enum":["S","M","L"],"type":"string","uniqueKey":"layout.layout.oneOf.2.size","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.2","typeLabel":"Side by Side · object"},{"type":"object","title":"TV Presenter","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","position","style"],"properties":{"kind":{"enum":["tv-presenter"],"type":"string","isRequired":true,"uniqueKey":"layout.layout.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"position":{"enum":["left","right"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.layout.oneOf.3.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.3","typeLabel":"TV Presenter · object"},{"type":"object","title":"Cut Out","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["cut-out"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.4.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.4","typeLabel":"Cut Out · object"},{"type":"object","title":"Camera Bubble","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","position","size"],"properties":{"kind":{"enum":["camera-bubble"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.layout.oneOf.5.position","typeLabel":"enum\u003cstring>"},"size":{"enum":["S","M","L"],"type":"string","isRequired":true,"uniqueKey":"layout.layout.oneOf.5.size","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"full\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.5.style","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.5","typeLabel":"Camera Bubble · object"},{"type":"object","title":"Camera Only","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","style"],"properties":{"kind":{"enum":["camera-only"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.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":"layout.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":"layout.layout.oneOf.6.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.6","typeLabel":"Camera Only · object"},{"type":"object","title":"Screen Only","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind","style"],"properties":{"kind":{"enum":["screen-only"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.layout.oneOf.7.style","typeLabel":"enum\u003cstring>"},"screenFit":{"description":"Only honoured when `style: \"fullscreen\"`. Defaults to cover.","enum":["cover","letterbox"],"type":"string","uniqueKey":"layout.layout.oneOf.7.screenFit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.7","typeLabel":"Screen Only · object"},{"type":"object","title":"Custom","description":"Structured layout for this section. Custom layouts, whether arranged in the editor or written through the API, report their geometry as `kind: custom`. Null only for internal layouts outside the public vocabulary.","required":["kind"],"properties":{"kind":{"enum":["custom"],"type":"string","isRequired":true,"uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.8.presentation.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"layout.layout.oneOf.8.presentation.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.8.presentation.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.8.presentation.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"layout.layout.oneOf.8.presentation.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.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":"layout.layout.oneOf.8.presentation.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.8.subject.dimensions.height","typeLabel":"number"},"width":{"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"layout.layout.oneOf.8.subject.dimensions.width","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.8.subject.dimensions","typeLabel":"object"},"hidden":{"description":"Leave the layer out of the picture. Defaults to false.","type":"boolean","uniqueKey":"layout.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":"layout.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":"layout.layout.oneOf.8.subject.point.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"layout.layout.oneOf.8.subject.point.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.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":"layout.layout.oneOf.8.subject.shape","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.8.subject","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"layout.layout.oneOf.8","typeLabel":"Custom · object"},{"type":"null","uniqueKey":"layout.layout.oneOf.9","typeLabel":"null"}],"uniqueKey":"layout.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 | null"},"popOut":{"oneOf":[{"type":"object","description":"The camera's pop-out while this layout shows. Absent when it is 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":"layout.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":"layout.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":"layout.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":"layout.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":"layout.popOut.oneOf.0.outlineWidth","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"layout.popOut.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"layout.popOut.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.popOut","typeLabel":"object | null"},"startTimeMs":{"oneOf":[{"description":"Layout start time in ms on the clip's playback timeline (cuts applied). Omitted for clip-spanning layouts.","example":0,"minimum":0,"type":"number","uniqueKey":"layout.startTimeMs.oneOf.0","typeLabel":"number"},{"description":"Layout start time in ms on the clip's playback timeline (cuts applied). Omitted for clip-spanning layouts.","example":0,"minimum":0,"type":"null","uniqueKey":"layout.startTimeMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.startTimeMs","typeLabel":"number | null"},"transitionStyle":{"oneOf":[{"type":"string","title":"LayoutTransitionStyle","description":"Transition into this layout. Omitted on the base layout, or when the section uses an internal style not exposed via the public API.","enum":["spring","hardCut"],"uniqueKey":"layout.transitionStyle.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"layout.transitionStyle.oneOf.1","typeLabel":"null"}],"uniqueKey":"layout.transitionStyle","typeLabel":"enum\u003cstring> | null"}},"required":["id","media"],"type":"object","isRequired":true,"uniqueKey":"layout","typeLabel":"object"}},"required":["layout"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"layout":{"id":"\u003cstring>","media":[{"type":"image","documentId":"\u003cstring>","height":0,"imageUrl":"\u003cstring>","muted":true,"slot":"screen","sourceId":"\u003cstring>","startTimeMs":123,"width":0}],"cameraStyle":"none","crop":{"bottom":1,"left":1,"right":1,"top":1},"durationMs":5000,"followsBase":true,"layout":{"kind":"fullscreen","screenFit":"cover","style":"regular"},"popOut":{"amount":0.25,"background":"original","color":"\u003cstring>","outlineColor":"\u003cstring>","outlineWidth":0.025},"startTimeMs":0,"transitionStyle":"spring"}}}},"exampleType":"generated"}},"description":"OK","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"},"6da9a3af-5616-425c-bc83-c2ba741cb394":{"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"},"513bf1e0-be89-4a3d-aad3-26269db46aa7":{"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"},"7c98c13d-923b-4821-91af-85b2a7e89dc2":{"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"},"4f7cb954-44de-426e-9da8-1073c20edb8c":{"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"},"00aa34cc-cf4a-4267-9dda-b787782cc9ce":{"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"},"61089d4e-c2d3-46e4-b07a-abc67e310baa":{"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"},"1d0c65fd-d083-417b-95f8-9c51323b2ec1":{"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"},"2c51ecc2-b13c-46c5-bed2-5ab99c254da5":{"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"},"b19d7432-fe1d-4bfb-b7e3-ff4b4a78b329":{"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":{"391dbe7e-1e55-4652-838c-14f99878a063":{"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":"Add a layout to a clip - Tella","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Help Center"},{"tab":"Developers"},{"tab":"Changelog"}]},"originalFileLocation":"api-reference/clips/add-a-layout-to-a-clip.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 a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.\">\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=\"Add a layout to a clip - Tella\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.\">\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/clips/add-a-layout-to-a-clip\">\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=Clips\u0026amp;title=Add+a+layout+to+a+clip\u0026amp;description=Adds+a+layout+to+a+clip.+Provide+both+startTimeMs+and+durationMs+for+a+time-ranged+layout%2C+or+omit+both+for+a+clip-spanning+layout.\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=04011f7851d9e21dc641a7473dece041fdece46fda05522900bb777d6d481977\">\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=\"Add a layout to a clip - Tella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Clips\u0026amp;title=Add+a+layout+to+a+clip\u0026amp;description=Adds+a+layout+to+a+clip.+Provide+both+startTimeMs+and+durationMs+for+a+time-ranged+layout%2C+or+omit+both+for+a+clip-spanning+layout.\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=04011f7851d9e21dc641a7473dece041fdece46fda05522900bb777d6d481977\">\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/clips/add-a-layout-to-a-clip\">\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/clips/add-a-layout-to-a-clip.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/clips/add-a-layout-to-a-clip#webpage\",\"url\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip\",\"name\":\"Add a layout to a clip\",\"description\":\"Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.\",\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip#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\":\"Clips\",\"item\":\"https://www.tella.com/docs/api-reference/clips/list-text-presets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Add a layout to a clip\",\"item\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip#apireference\",\"headline\":\"Add a layout to a clip\",\"name\":\"Add a layout to a clip\",\"description\":\"Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.\",\"url\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip\",\"mainEntityOfPage\":{\"@id\":\"https://www.tella.com/docs/api-reference/clips/add-a-layout-to-a-clip#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/clips/add-a-layout-to-a-clip.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","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","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","description":"Returns the layouts (sections) attached to 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","description":"Removes a layout from a clip.","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":"Add a layout to a clip - 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"]}