---
title: "Get a recording link"
method: POST
path: "/v1/videos/{id}/recording-link"
tags: ["Videos"]
---

# Get a recording link

`POST /v1/videos/{id}/recording-link`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/videos/{id}/recording-link`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/recording-link/post.ts> (a function with typed inputs; its response is checked against the schema)

A link the user opens to record a new clip, added at the end of the video. It opens the user's own recorder: the browser, or the Tella Mac or Windows app when they record there. A browser recording ends on a page that sends them back to the agent. The user must be signed in to Tella. To record into a new video, create an empty one first. Requires edit access.

## Path parameters

- `id` string, required: Unique video identifier

## Response `200`

OK

- RecordingLink
  - `url` string, required: Opens the user's recorder for a new clip at the end of the video. It needs the user to be signed in to Tella.
  - `videoId` string, required: The video the recording is added to

## 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

> 68 revisions in range; 1 not diffed.

- **2026-10-29** `6ae7d793a0a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/recording-link/post.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/5cbd6f2a0233?raw)