list_jobs

List your jobs across API keys, MCP connections and Design, without requiring a project.

Scope: jobs:read. Catalogue annotation: Read. Additional ownership and role checks may apply.

REST: GET /v1/jobs.

Arguments

Field

Type / accepted values

Required

Default

Constraints / meaning

limit

integer

No

25

minimum: 1; maximum: 100

after

string

No

""

maxLength: 64; pattern: "^[A-Za-z0-9_-]*$"

project_id

string (uuid) or null

No

null

view

"user" / "accessible" / "organization" or null

No

null

order

"id" / "newest"

No

"newest"

kind

"geometry" / "mesh" / "simulation" / "prediction" or null

No

null

state

"active" / "queued" / "submitting" / "submission_unknown" / "running" / "cancelling" / "cancelled" / "failed" / "succeeded" / "awaiting_decision" / "status_unavailable" or null

No

null

entry_point

"rest" / "mcp" / "python-sdk" / "design" / "studio" or null

No

null

user_id

string or null

No

null

maxLength: 100

credential_id

string (uuid) or null

No

null

created_after

number or null

No

null

minimum: 0

created_before

number or null

No

null

minimum: 0

q

string

No

""

maxLength: 120

Calling the tool

Use tools/call with this tool’s exact name and an arguments object matching the fields above. Get the complete live schema before supplying advanced controls:

{
  "name": "get_tool_schema",
  "arguments": {
    "name": "list_jobs",
    "include_definitions": false
  }
}

Result and continuation

Inspect isError and structuredContent. Keep returned job, operation and artifact IDs. A pending operation_id is followed with get_operation; a compute job is followed with get_job. A wait timeout does not cancel work. Follow returned polling intervals and retain the same idempotency key when reconciling the same submission.

See agent workflow, jobs and operations, uploads, results and error recovery for the applicable lifecycle. MCP annotations describe tool behaviour; they are not blanket permission to run paid work or change account state.