Update recording metadata

Rename a recording and/or move it into a folder.

PATCH /api/v1/spaces/{spaceId}/recordings/{recordingId}

API key in header x-api-key

curl 'https://transcript.lol/api/v1/spaces/space_01JXY9AZK4KV/recordings/recording_01JXY9AZK4KV' \
  --request PATCH \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "example",
  "recordingFolderId": "recording_folder_01JXY9AZK4KV"
}'

{
  "id": "id_01JXY9AZK4KV",
  "createdAt": "2026-01-01T12:00:00Z",
  "updatedAt": "2026-01-01T12:00:00Z",
  "workspaceId": "workspace_01JXY9AZK4KV",
  "title": "example",
  "sourceUrl": "https://example.com/source",
  "mediaType": "AUDIO",
  "source": "example",
  "duration": 1,
  "status": "MEDIA_IMPORT_UPLOADING",
  "recordingFolderId": "recording_folder_01JXY9AZK4KV",
  "isMediaDeleted": true,
  "createdById": "created_by_01JXY9AZK4KV",
  "autoDeleteMediaAfter": "example"
}

Recording metadata

Path parameters

· 2

spaceId string required

ID of the workspace. You can find from the url in dashboard when you open the workspace or using the list workspaces endpoint.

recordingId string required

ID of the recording. You can find from the url in dashboard when you open the workspace or using the list recordings endpoint.

Body

application/json

Recording fields to update — provide title, recordingFolderId, or both.

title string

New title for the recording.

recordingFolderId string · nullable

Move the recording into this folder. Pass null to move it out of any folder, back to the workspace root. Get folder IDs from the List folders endpoint.

Path parameters

Body

Responses