> ## Documentation Index > Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Split a clip in two > Split a clip in two at a time on its playback timeline, like the editor's split at the playhead. The clip keeps everything before `atMs`, and a new clip inserted right after it continues from there. Each cut, layout, zoom, blur, highlight and overlay goes to the part it sits on. One that spans `atMs` is split too: each part keeps its side, and a video, audio or sound effect overlay keeps playing in the second clip from where the first stopped. Both parts must play for at least 200 ms. Returns both clips in playback order; the first keeps the original clip's id. ## OpenAPI ````yaml /openapi.json post /v1/videos/{id}/clips/{clipId}/split openapi: 3.0.3 info: description: >- The Tella Public API allows you to programmatically access your videos and playlists, including transcripts, chapters, and thumbnails. ## Authentication All requests require a Bearer token in the Authorization header: ``` Authorization: Bearer tella_pk_xxxxx... ``` API keys can be generated in your Tella workspace settings. ## Rate Limiting The API is rate-limited to 200 requests per minute per user within a workspace. Rate limit information is returned in response headers: - `RateLimit-Policy`: Named quota, request limit, and window in seconds - `RateLimit`: Remaining quota and seconds until reset - `X-RateLimit-Limit`: Maximum requests per window - `X-RateLimit-Remaining`: Remaining requests in current window - `X-RateLimit-Reset`: Unix timestamp in milliseconds when the window resets A `429 Too Many Requests` response also includes `Retry-After` in seconds. title: Tella Public API version: 1.0.0 servers: - description: Production url: https://api.tella.com security: [] tags: - description: Video operations name: Videos - description: Sections of a video name: Clips - description: Playlist operations name: Playlists - description: Sidebar groups for organizing playlists name: Playlist Groups - description: Tags for categorizing and filtering videos name: Tags - description: 'Tella''s editor agent, working in a video: start a chat and follow it' name: Agent chats - description: >- Viewing analytics for a video or across the workspace: plays, watch time, retention, geography, referrers name: Analytics - description: The signed-in user, their workspace, its plan and agent credits name: Account - description: Personal, workspace, and default video backgrounds name: Backgrounds - description: >- Reusable media saved to a workspace, plus Tella's curated sound effect and background music catalogs — the same items the editor's media panels show name: Library - description: >- Motion graphics documents a video plays live as a Tella Motion clip, overlay or b-roll, edited with the editor's own commands name: Tella Motion - description: >- Screen walkthroughs an agent films of a web page with no one recording. Takes are started and read over the MCP server name: Auto Capture - description: Webhook endpoint management name: Webhooks externalDocs: description: API versioning and deprecation policy url: https://www.tella.com/docs/versioning paths: /v1/videos/{id}/clips/{clipId}/split: post: tags: - Clips summary: Split a clip in two description: >- Split a clip in two at a time on its playback timeline, like the editor's split at the playhead. The clip keeps everything before `atMs`, and a new clip inserted right after it continues from there. Each cut, layout, zoom, blur, highlight and overlay goes to the part it sits on. One that spans `atMs` is split too: each part keeps its side, and a video, audio or sound effect overlay keeps playing in the second clip from where the first stopped. Both parts must play for at least 200 ms. Returns both clips in playback order; the first keeps the original clip's id. operationId: splitClip parameters: - description: Video identifier in: path name: id required: true schema: description: Video identifier example: vid_abc123def456 type: string - description: Clip identifier in: path name: clipId required: true schema: description: Clip identifier example: cl_xyz789ghi012 type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SplitClipRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SplitClipResponse' description: OK headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '400': content: application/json: example: docsUrl: https://docs.tella.com/ error: bad_request message: The request was malformed or contained invalid parameters. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was malformed or contained invalid parameters. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '401': content: application/json: example: docsUrl: https://docs.tella.com/ error: unauthorized message: Authentication is required. Provide a valid API key. schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication is required. Provide a valid API key. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '403': content: application/json: example: docsUrl: https://docs.tella.com/ error: forbidden message: You don't have permission to access this resource. schema: $ref: '#/components/schemas/ErrorResponse' description: You don't have permission to access this resource. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '404': content: application/json: example: docsUrl: https://docs.tella.com/ error: not_found message: The requested resource was not found. schema: $ref: '#/components/schemas/ErrorResponse' description: The requested resource was not found. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '409': 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: $ref: '#/components/schemas/ErrorResponse' 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: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '429': content: application/json: example: docsUrl: https://docs.tella.com/ error: rate_limited message: You have exceeded the rate limit. Please slow down. schema: $ref: '#/components/schemas/ErrorResponse' description: You have exceeded the rate limit. Please slow down. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Retry-After: $ref: '#/components/headers/RetryAfter' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '500': content: application/json: example: docsUrl: https://docs.tella.com/ error: server_error message: An unexpected error occurred schema: $ref: '#/components/schemas/ErrorResponse' description: An unexpected error occurred headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '501': content: application/json: example: docsUrl: https://docs.tella.com/ error: not_implemented message: The requested operation is not implemented. schema: $ref: '#/components/schemas/ErrorResponse' description: The requested operation is not implemented. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' '503': 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: $ref: '#/components/schemas/ErrorResponse' description: >- A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay. headers: Deprecation: $ref: '#/components/headers/Deprecation' RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' security: - BearerAuth: [] components: schemas: SplitClipRequest: additionalProperties: false description: Request body for splitting a clip in two properties: atMs: description: >- Where to split, in ms on the clip's playback timeline (cuts applied, the same timeline as the transcript). At least 200 ms from either end of the clip. example: 12000 exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 type: integer required: - atMs type: object SplitClipResponse: additionalProperties: false description: Response shape for splitting a clip properties: clips: description: >- The two clips in playback order: the original clip, now ending at the split, and the new clip that continues from it. items: $ref: '#/components/schemas/Clip' type: array required: - clips type: object ErrorResponse: additionalProperties: false description: Standard error response format properties: docsUrl: description: Link to Tella API documentation example: https://docs.tella.com/ format: uri type: string 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 message: description: Human-readable error message example: Resource not found type: string required: - error - message - docsUrl type: object Clip: additionalProperties: false description: A section of a video properties: animatedCursor: description: >- Whether the clip draws an animated cursor from captured mouse data. Absent when the clip has no screen recording. example: true type: boolean background: $ref: '#/components/schemas/ClipBackgroundOutput' borderStyle: description: >- Border and shadow around the clip's frames — the editor Style panel's Border style. The clip's own value, else the video's. `custom` means the layers were styled one by one or with a retired preset; it can't be written. enum: - none - subtle-shadow - deep-shadow - transparent - solid-shadow-left - solid-shadow-right - snake - glass - custom example: subtle-shadow type: string cameraCrop: allOf: - $ref: '#/components/schemas/ClipCameraCropOutput' description: The camera's crop; null when uncropped. Absent without a camera. nullable: true cameraFocusPoint: allOf: - $ref: '#/components/schemas/ClipCameraFocusPointOutput' description: >- The camera's focus point (50/50 when never set). Absent without a camera. corners: description: >- Corner rounding of the clip's frames — the editor Style panel's Shape: `none` (square), `regular` (rounded) or `squircle` (very rounded). The clip's own value, else the video's. enum: - none - regular - squircle example: regular type: string createdAt: description: ISO 8601 datetime example: '2026-01-15T10:30:00.000Z' format: date-time type: string cuts: description: Time ranges cut from the clip's playback items: $ref: '#/components/schemas/CutOutput' type: array durationSeconds: description: Effective playback duration of the clip after cuts, in seconds example: 12.5 minimum: 0 type: number id: description: Unique clip identifier example: cl_xyz789ghi012 type: string keepCameraFaceCentered: description: Whether Keep face centered is on. Absent without a camera. example: false type: boolean layoutSceneType: allOf: - $ref: '#/components/schemas/LayoutSceneType' description: >- Determines which layouts can be applied to this clip via `add_layout`. See `BasicSubjectLayoutName`, `CameraSubjectLayoutName`, `CombiLayoutName`. maxDurationSeconds: description: Total length of the underlying source, in seconds example: 14.2 minimum: 0 type: number microphoneVolume: description: >- This clip's microphone volume override: a number when the clip overrides the video's `microphoneVolume`, null when it follows it, and absent when the clip has no microphone audio to control — either no such track, or a track whose recording carries no audio (a muted mic, or a screen recording made without sharing system audio). example: 0.4 maximum: 2 minimum: 0 nullable: true type: number mirrorCamera: description: >- Whether the clip's camera is mirrored (flipped horizontally). Absent when the clip has no camera. example: false type: boolean name: description: Clip display name example: Intro type: string order: description: Position of the clip within the video example: 0 maximum: 9007199254740991 minimum: 0 type: integer studioSound: description: >- Effective Studio Sound (AI audio enhancement) state for this clip: the video-level switch minus this clip's opt-out. example: false type: boolean systemAudioVolume: description: >- This clip's system audio (screen or uploaded footage) volume override, with the same three states as `microphoneVolume`. example: null maximum: 2 minimum: 0 nullable: true type: number transition: $ref: '#/components/schemas/ClipTransition' updatedAt: description: ISO 8601 datetime example: '2026-01-15T14:45:00.000Z' format: date-time type: string videoId: description: Video identifier example: vid_abc123def456 type: string required: - id - videoId - name - order - durationSeconds - maxDurationSeconds - cuts - layoutSceneType - background - transition - studioSound - corners - borderStyle - createdAt - updatedAt type: object ClipBackgroundOutput: additionalProperties: false description: >- Clip background. Use type = 'solid' with `color`, type = 'image' or 'video' with `sourceId` (from `POST /v1/sources`) or an exact catalog URL from `GET /v1/backgrounds`, type = 'gradient' with `gradientColor1`, `gradientColor2`, `gradientAngle`, type = 'shaderGradient' with `shaderGradientPreset`, or type = 'ambient'. properties: color: description: Hex color string. Required when type = 'solid'. example: '#000000ff' nullable: true type: string gradientAngle: description: Linear gradient angle in degrees. Required when type = 'gradient'. example: 45 maximum: 9007199254740991 minimum: -9007199254740991 nullable: true type: integer gradientColor1: description: Hex color string. Required when type = 'gradient'. example: '#ff0080ff' nullable: true type: string gradientColor2: description: Hex color string. Required when type = 'gradient'. example: '#7928caff' nullable: true type: string imageUrl: description: >- Hosted image URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`. format: uri nullable: true type: string shaderGradientPreset: description: >- Animated gradient preset from `GET /v1/backgrounds`. Required when type = 'shaderGradient'. example: Halo nullable: true type: string sourceId: description: >- Source ID from `POST /v1/sources` (`kind: image` for type = 'image', `kind: video` for type = 'video'). Required for image/video backgrounds unless using an exact URL from `GET /v1/backgrounds`. Input-only. example: su_abc123 nullable: true type: string type: description: >- Background variant. `ambient`: the clip's screen, else its camera, heavily blurred; no other fields. `shaderGradient`: an animated gradient set by `shaderGradientPreset`; echoing a non-preset one unchanged keeps it. enum: - solid - gradient - image - video - shaderGradient - ambient example: solid type: string videoDurationSeconds: description: >- Video background duration in seconds. Read-only: derived from the uploaded source or catalog entry on input. example: 12.4 minimum: 0 nullable: true type: number videoUrl: description: >- Hosted video URL. Present in responses and accepted as input only when copied exactly from `GET /v1/backgrounds`; otherwise pass `sourceId`. format: uri nullable: true type: string required: - type type: object ClipCameraCropOutput: additionalProperties: false description: >- Pixels removed from each edge of the unmirrored camera recording. The edges must leave a visible area. properties: bottom: description: Pixels of the camera recording removed from its bottom edge minimum: 0 type: number left: description: Pixels of the camera recording removed from its left edge minimum: 0 type: number right: description: Pixels of the camera recording removed from its right edge minimum: 0 type: number top: description: Pixels of the camera recording removed from its top edge minimum: 0 type: number required: - top - right - bottom - left type: object ClipCameraFocusPointOutput: additionalProperties: false description: >- The part of the unmirrored, cropped camera recording kept in view when the camera frame's shape differs from it: 0 keeps the left/top edge, 50 the middle, 100 the right/bottom. The face's position keeps the face in frame. example: xPct: 50 yPct: 35 properties: xPct: description: Horizontal position, 0-100 maximum: 100 minimum: 0 type: number yPct: description: Vertical position, 0-100 maximum: 100 minimum: 0 type: number required: - xPct - yPct type: object CutOutput: additionalProperties: false description: >- A range of the raw recording removed from playback. Cut definitions are the one place raw-recording coordinates appear: replacing the cut set describes the playback timeline you'd get after clearing all cuts. Cuts are always undoable — replace with `[]` to restore everything. properties: durationMs: description: Length of the cut, in milliseconds example: 750 exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 type: integer startTimeMs: description: Start of the cut, in ms of the raw recording example: 1500 maximum: 9007199254740991 minimum: 0 type: integer required: - startTimeMs - durationMs type: object LayoutSceneType: description: >- How a clip composes its layers, which determines the set of layouts it accepts: `basicSubject` (screen-only), `cameraSubject` (camera-only), or `combi` (camera + presentation). enum: - basicSubject - cameraSubject - combi example: combi type: string ClipTransition: description: >- How a clip enters from the previous one. `default` inherits the video's `defaultClipTransition`; `smooth` and `hard_cut` override it for this clip. The first clip in a video has nothing to transition from. enum: - default - smooth - hard_cut example: default type: string 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 RateLimitPolicy: 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 XRateLimitLimit: description: Maximum requests allowed in the current window example: 100 schema: type: integer XRateLimitRemaining: description: Requests remaining in the current window example: 95 schema: type: integer XRateLimitReset: description: Unix timestamp in milliseconds when the window resets example: 1704067200000 schema: format: int64 type: integer RetryAfter: description: Seconds to wait before retrying a rate-limited request example: 45 schema: minimum: 1 type: integer securitySchemes: BearerAuth: description: API key obtained from your Tella account settings scheme: bearer type: http ```` ## Related topics - [Clips](https://www.tella.com/docs/mcp-tools/clips.md) - [Cut and split clips](https://www.tella.com/docs/help/editing/trim-and-split-clips.md) - [Can I combine two separate recordings into one video?](https://www.tella.com/docs/help/faq/combine-separate-recordings.md) - [Replace a section of your video](https://www.tella.com/docs/help/editing/replace-a-section-of-your-video.md) - [Generate auto layouts](https://www.tella.com/docs/help/editing/use-auto-layouts.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.