v3

latestOpenAPI 3.0.0Proprietary2026-08-041323140.2 KB
API Endpoints

Get job status

Retrieve the status of any job.

The response format varies based on job type and includes type-specific fields.

get/jobs/{job_id}

Path parameters

job_idstring uuid required

The job ID

Response

Job status retrieved successfully

OR
OR

Example response

{
  "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"
      }
    ]
  }
}