REST ClientVideoVideoRoomRecordings

list

View as MarkdownOpen in Claude

List video room recordings.

Query parameters

media_ttlintegerOptional
Generated media links will be valid for this many seconds. Default is 900 (15 minutes).
page_numberintegerOptional>=0Defaults to 0
Page number to return. Requires `page_token` for values greater than 0.
page_sizeintegerOptional1-1000Defaults to 50
Specify the number of results to return on a single page. The default page size is `50` and the maximum is `1000`.
page_tokenstringOptional
Token for cursor-based pagination. Required when `page_number` is greater than 0.

Response

datalist of objectsRequired
List of room recordings.

Response Example

Response
1{
2  "links": {
3    "self": "https://example.signalwire.com/api/video/rooms?page=2",
4    "first": "https://example.signalwire.com/api/video/rooms?page=1",
5    "next": "https://example.signalwire.com/api/video/rooms?page=3",
6    "prev": "https://example.signalwire.com/api/video/rooms?page=1"
7  },
8  "data": [
9    {
10      "id": "c22d24f6-5a47-4597-9a23-c7d01e696b92",
11      "room_session_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
12      "status": "completed",
13      "started_at": "2022-01-01T10:00:00Z",
14      "finished_at": "2022-01-01T11:00:00Z",
15      "duration": 120,
16      "size_in_bytes": 20971520,
17      "format": "video/mp4",
18      "cost_in_dollars": 0.05,
19      "uri": "https://files.signalwire.com/temporary/link/to/the/recording/file",
20      "created_at": "2022-01-01T10:00:00Z",
21      "updated_at": "2022-01-01T11:00:00Z"
22    }
23  ]
24}

Example

1from signalwire.rest import RestClient
2
3client = RestClient(
4    project="your-project-id",
5    token="your-api-token",
6    host="your-space.signalwire.com",
7)
8
9recordings = client.video.room_recordings.list()