v106

OpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-03812347972.4 KB
job

get the ids of all queued jobs matching the given filters

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

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

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

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)

concurrency_keystring
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

uuids of jobs

string[] required