List Jobs V1
List jobs for the authenticated tenant. Mirrors the dashboard’s /api/jobs/ filters + cursor pagination so v1 callers can enumerate their own runs without…
GET
List jobs for the authenticated tenant.
Mirrors the dashboard’s
/api/jobs/ filters + cursor pagination so v1
callers can enumerate their own runs without remembering every job id.
Query parameters
string,null
Filter to a single status: queued, running, succeeded, failed, cancelled, awaiting_approval
string,null
Filter to a specific agent_type / template name
string,null
Substring match against job id or summary
string[],null
Filter to jobs that carry every supplied tag (AND-match). Repeat the parameter to require multiple tags:
?tag=env:prod&tag=owner:billing-team.string
field:dir — field is one of created_at|updated_at|status|template|cost_usd; dir is asc|desc
integer
integer
string,null
Opaque cursor from a previous response’s X-Next-Cursor header. When set, supersedes
offset and pages strictly past the seed row using a seek predicate. Only valid for sort=created_at.Response
JobStatusResponse[] — each element:
string
required
Job UUID.
string
required
Current status: queued, running, succeeded, failed, cancelled, awaiting_approval.
string
required
Agent type / template that was used.
string,null
Pipe-separated final assistant text. Populated when the job reaches a terminal state. Truncated to ≈5 segments × 280 chars.
string,null
Human-readable error message when status is ‘failed’ or ‘cancelled’.
integer,null
Cumulative input tokens consumed.
integer,null
Cumulative output tokens generated.
number,null
Cumulative billable cost. Priced at the job’s selected model rate (not the deployment default).
string
required
ISO 8601 UTC timestamp.
string
required
ISO 8601 UTC timestamp; refreshed on every iteration.