Media
Events
Requests, objects, and responses.
Page by seq: asc with after_seq, desc with before_seq. Never combine both cursors.
List events
GET /media/v1/libraries/{library_id}/events
| Parameter | Location | Type | Description |
|---|---|---|---|
| library_id | path | string | Library ID |
| after_seq | query | integer | Ascending cursor; cannot combine with before_seq |
| before_seq | query | integer | Descending cursor; cannot combine with after_seq |
| order | query | asc / desc | asc (default) or desc |
| limit | query | integer | 1–200 items per page, default 50 |
Returns: MediaEventPage.
Response
HTTP 200
Successful response.
application/json
| Name | Type | Description |
|---|---|---|
| data | array<object> | Events in this page, ordered by sequence in the requested direction. |
| data[].seq | number | Increasing sequence number within this library; use it with after_seq or before_seq to page through events. |
| data[].id | string | Unique identifier of this recorded event. |
| data[].type | string | Type of lifecycle, asset, processing, search or batch change recorded. |
| data[].processed_at | string | Time this event was recorded, in UTC. |
| data[].library_id | string | Identifier of the library whose event was recorded. |
| data[].asset_id | string | Related asset identifier, when the event concerns an asset. |
| data[].job_id | string | Related batch job identifier, when present. |
| data[].kind | string | Related processing task: visual, frames, transcript or embedding. |
| data[].detail | object | Event-specific details, such as changed values, reprocessing kinds or failed-item counts. |
| next_cursor | string | null | Last returned sequence as a string when more events exist; convert to a number and pass as after_seq for asc or before_seq for desc. Null means no further page. |
curl -X GET "https://api.deepraxis.ai/media/v1/libraries/${LIBRARY_ID}/events?limit=1" \
-H "Authorization: Bearer $PRAXIS_API_KEY"HTTP 200
{
"data": [
{
"seq": 1,
"id": "2cd2cd71-1fc5-41fc-aeb0-29583af9b900",
"type": "library.status_provisioning",
"processed_at": "2026-10-09T09:34:09.858Z",
"library_id": "lib_fff73e25733449b1bf6f880d91f5c045"
}
],
"next_cursor": "1"
}MediaEventPage
| Field | Type | Required | Description |
|---|---|---|---|
| data | MediaEvent[] | yes | Results in this page |
| next_cursor | string / null | yes | Next-page cursor; null or absent at the end |
MediaEvent
| Field | Type | Required | Description |
|---|---|---|---|
| seq | number | yes | Increasing event sequence within the library |
| id | string | yes | Resource ID |
| type | MediaEventType | yes | Resource or event type |
| processed_at | IsoTimestamp | yes | Event timestamp |
| library_id | LibraryId | yes | Library ID |
| asset_id | AssetId | no | Asset ID |
| job_id | JobId | no | Job ID |
| kind | ProcessingKind | no | Understanding or processing kind; filters the understanding list |
| detail | object | no | Event details |