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
- 200
- 400
- 401
- 403
- 404
- 500
List jobs
Response Headers
Bad request
Unauthorized
The connection does not hold the required scope
Not found
Internal server error