The recordings operations are deprecated in 2.0. Use the /videos endpoints instead.
Operations related to recordings, which are created through the /live_streams
or /transcoders
resources. The Wowza Video service can create MP4 recordings of your live streams and transcoded output. Recordings can be downloaded and saved locally. They're based on the highest-bitrate output rendition that Wowza Video generates from your video source. See About recordings to learn more.
The recordings operations are deprecated in 2.0. Use the /videos endpoints instead.This operation shows limited details for all of your recordings. For detailed information, fetch a single recording.
filter | string Restricts the data that gets returned by filtering on one or more values associated with a field. Construct a filter using a two-part expression that specifies the field on which to filter and the logic to use to filter. Filters use a zero-based index. For valid filter operators and filter fields, see How to get filtered query results with the Wowza Video REST API. Example: filter[0][field]=state&filter[0][eq]=stopped |
page | integer Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. For more information and examples, see Get paginated query results with the Wowza Video REST API. |
per_page | integer For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000. |
Success
Unauthorized
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v2.0/recordings"
{- "recordings": [
- {
- "id": "4Jjzstdt",
- "transcoder_id": "bjaplmrw",
- "state": "converting",
- "reason": "",
- "file_name": "31a4f9f4.stream.0.mp4",
- "created_at": "2023-01-29T17:16:21.993Z",
- "updated_at": "2023-01-31T10:37:57.993Z"
}, - {
- "id": "fFWxVsyj",
- "state": "completed",
- "reason": "",
- "file_name": "my_rts_recording.mp4",
- "asset_id": "thfsm6c2",
- "real_time_asset_id": "xbzk91ts",
- "created_at": "2023-01-28T17:16:21.993Z",
- "updated_at": "2023-01-30T21:34:45.993Z"
}
]
}
The recordings operations are deprecated in 2.0. Use the /videos endpoints instead.This operation shows the details of a specific recording.
Success
required | object (recording) | ||||||||||||||||||||||||||||||
|
Unauthorized
Forbidden
Not Found
Gone
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v2.0/recordings/2adffc17"
{- "recording": {
- "created_at": "2020-01-29T17:16:21.993Z",
- "duration": 362905,
- "file_name": "00a613bf@367500.stream.0.mp4",
- "file_size": 53113429,
- "id": "4Jjzstdt",
- "reason": "",
- "starts_at": "2020-02-01T00:00:00.000Z",
- "transcoding_uptime_id": "vxyz9876",
- "state": "completed",
- "transcoder_id": "bjQplmRw",
- "transcoder_name": "My Camera",
- "updated_at": "2020-01-30T17:22:20.993Z"
}
}
The recordings operations are deprecated in 2.0. Use the /videos endpoints instead.
This operation deletes a recording.
Note: You can't remove recordings that have an asset_id. Assets must be removed by sending a DEL request to the /assets endpoint.
No Content
Unauthorized
Forbidden
Not Found
Gone
Unprocessable Entity
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "DELETE" \ "${WV_HOST}/api/v2.0/recordings/2adffc17"
{- "Example Response 1": {
- "meta": {
- "status": 401,
- "code": "ERR-401-NoApiKey",
- "title": "No API Key Error",
- "message": "No API key sent in header.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 2": {
- "meta": {
- "status": 401,
- "code": "ERR-401-NoAccessKey",
- "title": "No Access Key Error",
- "message": "No access key sent in header.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 3": {
- "meta": {
- "status": 401,
- "code": "ERR-401-InvalidApiKey",
- "title": "Invalid Api Key Error",
- "message": "Invalid API key.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 4": {
- "meta": {
- "status": 401,
- "code": "ERR-401-InvalidAccessKey",
- "title": "Invalid Access Key Error",
- "message": "Invalid access key.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 5": {
- "meta": {
- "status": 401,
- "code": "ERR-401-BadAccountStatus",
- "title": "Bad Account Status Error",
- "message": "Your account's status doesn't allow this action.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 6": {
- "meta": {
- "status": 401,
- "code": "ERR-401-FeatureNotEnabled",
- "title": "Feature Not Enabled Error",
- "message": "This feature isn't enabled.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 7": {
- "meta": {
- "status": 401,
- "code": "ERR-401-TrialExceeded",
- "title": "Bad Billing Status Error",
- "message": "Your billing status needs attention. You can't start or add live streams until your billing status is updated.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 8": {
- "meta": {
- "status": 401,
- "code": "ERR-401-ExpiredToken",
- "title": "JWT is expired",
- "message": "Token has exired.",
- "description": "",
- "links": [ ]
}
}, - "Example Response 9": {
- "meta": {
- "status": 401,
- "code": "ERR-401-InvalidToken",
- "title": "JWT is invalid",
- "message": "Token is invalid.",
- "description": "",
- "links": [ ]
}
}
}
The recordings operations are deprecated in 2.0. Use the /videos endpoints instead.
This operation shows the current state of a recording.
// Using cURL curl -H "Authorization: Bearer ${WV_JWT}" \ -H "Content-Type: application/json" \ -X "GET" \ "${WV_HOST}/api/v2.0/recordings/2adffc17/state"
{- "recording": {
- "state": "completed"
}
}