Skip to main content

List jobs

GET 

/api/v1/operator/jobs

Lists job summaries by status, operation, subject or recency. Payloads, result metadata, lease and claim data, error text and requester ids are never returned. Free-text search is not offered, because the underlying job search also reads agent names and hostnames. Authenticated only with an operator connection credential holding the mcp:jobs:read scope; the workspace comes from the connection. Response shape: packages/contracts/mcp/mcp-read-tools.schema.json definition tt_list_jobs_output (tool tt_list_jobs). Unknown or repeated query parameters are refused with 400. Hidden with 404 while the operator interface or CertOps is disabled.

Request​

Responses​

List jobs

Response Headers
    Cache-Control