Skip to main content
GET
List background jobs
This lists the jobs you started here and the ones your in-app agents started. open=true keeps only jobs still queued or running. origin_kind keeps one kind of starter: session (a chat session), igris (Igris), brain (a workflow’s Brain), or api (the API or an AI assistant). origin_id keeps the jobs one session or workflow started. Each item has the fields of Get a background job. Needs jobs:read. MCP tool: list_jobs.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Query Parameters

open
boolean
default:false

Only jobs still queued or running. Default: every one.

origin_kind
enum<string> | null

Only jobs started by this kind of caller.

Available options:
igris,
session,
brain,
api
origin_id
string | null

Only jobs started by this session or workflow.

Maximum string length: 255
limit
integer
default:100

Items per page, 1–100.

Required range: 1 <= x <= 100
cursor
string | null

next_cursor of the previous page.

Response

A page of your background jobs.

jobs
Job · object[]
required
has_more
boolean
required
read-only

True when there is a next page (next_cursor is not null).

next_cursor
string | null

Pass as ?cursor= for the next page; null on the last page.