Sign in
job

list all queued jobs

get/w/{workspace}/jobs/queue/list

Path parameters

workspacestring required

Query parameters

order_descboolean

order by desc order (default true)

created_bystring

filter by exact matching user creator. Supports comma-separated list (e.g. 'alice,bob') and negation by prefixing all values with '!' (e.g. '!alice,!bob')

parent_jobstring uuid

The parent job that is at the origin and responsible for the execution of this script if any

workerstring

filter by worker this job ran on. Supports comma-separated list (e.g. 'worker-1,worker-2') and negation by prefixing all values with '!' (e.g. '!worker-1,!worker-2')

script_path_exactstring

filter by exact matching script path. Supports comma-separated list (e.g. 'f/script1,f/script2') and negation by prefixing all values with '!' (e.g. '!f/script1,!f/script2')

script_path_startstring

filter by script path prefix. Supports comma-separated list (e.g. 'f/folder1,f/folder2') and negation by prefixing all values with '!' (e.g. '!f/folder1,!f/folder2')

schedule_pathstring

mask to filter by schedule path

trigger_pathstring

filter by trigger path. Supports comma-separated list (e.g. 'f/trigger1,f/trigger2') and negation by prefixing all values with '!' (e.g. '!f/trigger1,!f/trigger2')

trigger_kindstring

filter by trigger kind. Supports comma-separated list (e.g. 'schedule,webhook') and negation by prefixing all values with '!' (e.g. '!schedule,!webhook')

script_hashstring

mask to filter exact matching path

started_beforestring date-time

filter on started before (inclusive) timestamp

started_afterstring date-time

filter on started after (exclusive) timestamp

successboolean

filter on successful jobs

scheduled_for_before_nowboolean

filter on jobs scheduled_for before now (hence waitinf for a worker)

job_kindsstring

filter by job kind. Supports comma-separated list of values ('preview', 'script', 'dependencies', 'flow') and negation by prefixing all values with '!' (e.g. '!preview,!dependencies')

suspendedboolean

filter on suspended jobs

runningboolean

filter on running jobs

argsstring

filter on jobs containing those args as a json subset (@> in postgres)

resultstring

filter on jobs containing those result as a json subset (@> in postgres)

allow_wildcardsboolean

allow wildcards (*) in the filter of label, tag, worker

tagstring

filter by tag/worker group. Supports comma-separated list (e.g. 'gpu,highmem') and negation by prefixing all values with '!' (e.g. '!gpu,!highmem')

pageinteger

which page to return (start at 1, default 1)

per_pageinteger

number of items to return for a given page (default 30, max 100)

all_workspacesboolean

get jobs from all workspaces (only valid if request come from the admins workspace)

is_not_scheduleboolean

is not a scheduled job

Response

All queued jobs

workspace_idstring
idstring uuid required
parent_jobstring uuid
created_bystring
created_atstring date-time
started_atstring date-time
scheduled_forstring date-time
runningboolean required
script_pathstring
script_hashstring
argsScriptArgs

The arguments to pass to the script or flow

logsstring
raw_codestring
canceledboolean required
canceled_bystring
canceled_reasonstring
last_pingstring date-time
job_kind'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent' | 'unassigned_script' | 'unassigned_flow' | 'unassigned_singlestepflow' required
schedule_pathstring
permissioned_asstring required

The user (u/userfoo) or group (g/groupfoo) whom the execution of this script will be permissioned_as and by extension its DT_TOKEN.

flow_statusFlowStatus — unresolved $ref
raw_flowFlowValue — unresolved $ref
is_flow_stepboolean required
language'python3' | 'deno' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'bun' | 'php' | 'rust' | 'ansible' | 'csharp' | 'nu' | 'java' | 'ruby' | 'rlang' | 'duckdb' | 'bunnative' | 'dbt'
emailstring required
visible_to_ownerboolean required
mem_peakinteger
tagstring required
priorityinteger
self_wait_time_msnumber
aggregate_wait_time_msnumber
suspendnumber
preprocessedboolean
is_retryboolean
trigger_kind'webhook' | 'default_email' | 'email' | 'schedule' | 'http' | 'websocket' | 'postgres' | 'kafka' | 'nats' | 'mqtt' | 'amqp' | 'sqs' | 'gcp' | 'azure' | 'google' | 'github' | 'asset' | 'freshness' | 'app' | 'ui'

job trigger kind (schedule, http, websocket...)

workerstring

Changes