Skip to content
SHAMPOO

Tool catalogue

jobs_list

Read · Ordinary · Jobs and lanes

jobs_list

  • Category: jobs_lanes
  • Access: read
  • Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Jobs, optional state filter.

Arguments

Optional: state.

  • state. Note: Optional queued|claimed|completed|failed filter.

Result

JSON object with jobs array (newest first, capped at 100).

Boundaries

Project-scoped; out-of-scope reads as missing. Owner-or-conductor on claimed rows.

Lifecycle / side effects

queued -> claimed -> completed|failed (terminal) or fail-requeued; attempts kept.

Errors

Bad ids/states rejected. Failures move nothing (atomic).

Example

{}

Result shape:

{
  "jobs": []
}

See also

job_create, job_claim.

On this page