Transcode Task List (Batch)
Retrieves multiple transcoding tasks by their IDs in a single request.
Request
| Property | Value |
|---|---|
| Method | POST |
| URL | /api/transcode/active/batch |
| Content-Type | application/json |
| Authentication | Bearer Token |
Request
bashcurl -X POST "{BASE_URL}/api/transcode/active/batch" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"key": "value"}'
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
data.ids | string[] | Yes | Array of task IDs to retrieve |
Request Body
json{
"data": {
"ids": ["p_v7t8b218mj1x74ux", "p_f81yhse9mj1x6nk8"]
}
}
Response Body
Result Arrays
| Parameter | Type | Description |
|---|---|---|
data.found | array | Array of found task objects |
data.notFound | string[] | Array of task IDs that were not found |
Task Object (in data.found[])
| Parameter | Type | Description |
|---|---|---|
data.found[].id | string | Unique identifier of the task |
data.found[].type | string | Task type |
data.found[].state | string | Task state |
data.found[].applicationName | string | Application name |
data.found[].streamKey | string | Stream key |
data.found[].subStream | string | Sub-stream name |
data.found[].startTime | integer | Task start time (Unix timestamp in ms) |
data.found[].duration | integer | Task duration in milliseconds |
data.found[].readPackets | integer | Number of packets read |
data.found[].writePackets | integer | Number of packets written |
data.found[].errorCount | integer | Number of errors encountered |
data.found[].isReader | boolean | Indicates if task is reading data |
data.found[].isWriter | boolean | Indicates if task is writing data |
Metadata
| Parameter | Type | Description |
|---|---|---|
meta.executionTime | integer | Request processing time in milliseconds |
meta.generatedAt | integer | Response generation timestamp (Unix timestamp in ms) |
Successful Response (200)
json{
"data": {
"found": [
{
"id": "p_v7t8b218mj1x74ux",
"type": "FILE_READER",
"state": "RUNNING",
"applicationName": "origin",
"streamKey": "eternals",
"subStream": "native",
"startTime": 1765486700905,
"duration": 305629206,
"readPackets": 10209191,
"writePackets": 0,
"errorCount": 0,
"isReader": true,
"isWriter": true
}
],
"notFound": [
"p_f81yhse9mj1x6nk8"
]
},
"meta": {
"executionTime": 0,
"generatedAt": 1765793419437
}
}
Error Response (4xx/5xx)
| Parameter | Type | Description |
|---|---|---|
message | string | Human-readable error message |
json{
"message": "Error message"
}
Support Needed?
Create a free ticket and our support team will provide you necessary assistance.