Skip to main content
GET
Get job status

Authorizations

Authorization
string
header
required

Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.

Path Parameters

job_id
string<uuid>
required

The job ID

Response

Job status retrieved successfully

Status of an async job. The response structure varies based on the job type. Use the job_type field to determine which fields will be present.

job_id
string<uuid>
required

Unique identifier for the job

Example:

"6dc3f30a-58c2-4174-96a6-dc18cf3c7776"

job_type
enum<string>
required

Type of job

Available options:
import/project_media
job_state
enum<string>
required

Current state of the job:

  • queued: Job is waiting to start
  • running: Job is actively processing
  • stopped: Job has finished (check result.status for outcome)
  • cancelled: Job was cancelled by user
Available options:
queued,
running,
stopped,
cancelled
Example:

"stopped"

created_at
string<date-time>
required

When the job was created

Example:

"2025-11-18T10:30:00Z"

drive_id
string<uuid>
required

The drive ID

Example:

"c9c5c47e-158a-49f7-846b-4f6ee2a229a2"

project_id
string<uuid>
required

The project ID

Example:

"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb"

project_url
string<uri>
required

URL to access the project in Descript web app. When a composition ID is available in the result, the URL includes a composition short ID suffix.

Example:

"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb"

stopped_at
string<date-time>

When the job stopped (only present when job_state is stopped or cancelled)

Example:

"2025-11-18T10:35:00Z"

progress
object

Progress information for the workflow (only present when job_state is running)

result
ImportSuccessResult · object

Job result (only present when job_state is stopped)