List jobs
List recent jobs with optional filtering by project or job type.
By default, jobs created within the last 7 days are returned. Use created_after and created_before to customize the time range. The maximum lookback is 30 days.
Results are paginated. Use the cursor from the response pagination.next_cursor to fetch subsequent pages.
Query parameters allow you to filter the results:
- Filter by project_id to see all jobs for a project
- Filter by type to see specific job types (import/project_media, agent)
Query parameters
Filter by project ID
Filter by job type
Cursor for the next page of results, obtained from pagination.next_cursor in a previous response
Number of items per page (1-100). Defaults to 20.
Filter jobs created after this timestamp (ISO 8601). Default: 7 days ago. Oldest allowed: 30 days ago.
Filter jobs created before this timestamp (ISO 8601). Default: now.
Response
Jobs list retrieved successfully
Example response
{
"data": [
{
"job_id": "6dc3f30a-58c2-4174-96a6-dc18cf3c7776",
"job_state": "stopped",
"created_at": "2025-11-18T10:30:00Z",
"stopped_at": "2025-11-18T10:35:00Z",
"drive_id": "c9c5c47e-158a-49f7-846b-4f6ee2a229a2",
"project_id": "9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb",
"project_url": "https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb",
"progress": {
"label": "Importing media...",
"percent": 50,
"last_update_at": "2025-11-18T10:32:00Z"
},
"result": {
"status": "success",
"media_status": {
"Misc/intro.mp4": {
"status": "success",
"duration_seconds": 10.5
},
"demo.mp4": {
"status": "success",
"duration_seconds": 125
}
},
"media_seconds_used": 75,
"created_compositions": [
{
"id": "0daabc7a-437a-43eb-b04b-b398d502f393",
"name": "Rough Cut"
}
]
}
}
]
}