--- title: "Remove a shape overlay" method: DELETE path: "/v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}" tags: ["Clips"] --- # Remove a shape overlay `DELETE /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}` ## Request - Base URL: `https://api.tella.com` - URL: `https://api.tella.com/v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Removes a shape overlay from a clip. ## Path parameters - `id` string, required: Video ID - `clipId` string, required: Clip ID - `shapeOverlayId` string, required: Shape overlay ID ## Response `200` Shape overlay removed - SuccessResponse: Standard success response for operations that don't return data - `status` 'ok', required: Operation status ## Other responses - `400`: The request was malformed or contained invalid parameters. - `401`: Authentication is required. Provide a valid API key. - `403`: You don't have permission to access this resource. - `404`: The requested resource was not found. - `409`: 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. - `429`: You have exceeded the rate limit. Please slow down. - `500`: An unexpected error occurred - `501`: The requested operation is not implemented. - `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay. ## Changes > 72 revisions in range; 1 not diffed. - **2026-10-28** `458e1aabe63c`: 1 info - endpoint added [Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/clips/:clipId/shape-overlays/:shapeOverlayId/delete.md) --- [API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/ca74daaf9201?raw)