Clips

Auto-crop a clip's screen recording

Changed on Sep 28, 2026

Detects the visible content at a frame and applies the recommended crop to the clip's screen recording. The frame time uses the clip playback timeline, with cuts already removed. Existing masks and custom-layout geometry are adjusted with the crop.

post/v1/videos/{id}/clips/{clipId}/auto-crop

Request

Base URL
https://api.tella.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/clips/:clipId/auto-crop/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Video identifier

Example:vid_abc123def456

clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

inpointMsinteger

Frame time in ms on the clip's playback timeline (cuts applied). Defaults to 0.

Example request

{
  "inpointMs": 1000
}

Response

Crop applied

aspectRatiostring required

confidencenumber required

inpointMsinteger required

Requested time on the clip playback timeline

Changes

Sep 28, 2026ac47c99c144f Revision changes
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
Sep 9, 20266b1132ef42fb Revision changes
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history