Skip to main content
GET
List jobs

Authorizations

Authorization
string
header
required

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

Query Parameters

project_id
string<uuid>

Filter by project ID

type
enum<string>

Filter by job type

Available options:
import/project_media,
agent
cursor
string

Cursor for the next page of results, obtained from pagination.next_cursor in a previous response

limit
integer
default:20

Number of items per page (1-100). Defaults to 20.

Required range: 1 <= x <= 100
created_after
string<date-time>

Filter jobs created after this timestamp (ISO 8601). Default: 7 days ago. Oldest allowed: 30 days ago.

created_before
string<date-time>

Filter jobs created before this timestamp (ISO 8601). Default: now.

Response

Jobs list retrieved successfully

data
object[]
required

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.

pagination
object
required