List job runs, newest first

GET /ops/jobs/runs

Authorization

bearer

Authorizationheader · stringrequired

Session token from POST /v1/auth/login with "transport": "bearer". Browsers use the session cookie that login sets instead.

Query

kindstring

Only jobs of this definition or kind

maxLength: 63

queuestring

maxLength: 100

statearray of string

Only jobs in these states: available, cancelled, completed, discarded, pending, retryable, running, scheduled

nullable

limitinteger

format: int64default: 50minimum: 1maximum: 100

cursorstring

next_cursor from the previous page

maxLength: 1000

Responses

errors: application/problem+json

200

400

Bad Request

401

Unauthorized

403

Forbidden

422

Unprocessable Entity

500

Internal Server Error

Match errors on the problem's code, which stays the same, not on its message.

Send a request

Server

Bearer token

kind query

queue query

state query

limit query

cursor query

The request goes from your browser straight to this server; nothing passes through this site. The API must allow this site's origin for CORS.

Requestexample

curl "$API_URL/ops/jobs/runs" \
  -H "Authorization: Bearer $TOKEN"

req, err := http.NewRequestWithContext(ctx, http.MethodGet,
	apiURL + "/ops/jobs/runs", nil)
if err != nil {
	return err
}
req.Header.Set("Authorization", "Bearer "+token)
res, err := http.DefaultClient.Do(req)
if err != nil {
	return err
}
defer res.Body.Close()

const res = await fetch(`${apiUrl}/ops/jobs/runs`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
  },
});
const data = await res.json();

Responseexample

{
  "jobs": [
    {
      "attempt": 0,
      "created_at": "2026-09-15T12:00:00Z",
      "id": 0,
      "kind": "heartbeat",
      "max_attempts": 0,
      "priority": 0,
      "queue": "string",
      "scheduled_at": "2026-09-15T12:00:00Z",
      "state": "completed",
      "actor_id": "string",
      "actor_kind": "string",
      "attempted_at": "2026-09-15T12:00:00Z",
      "errors": [
        {
          "at": "2026-09-15T12:00:00Z",
          "attempt": 0,
          "message": "string"
        }
      ],
      "finalized_at": "2026-09-15T12:00:00Z",
      "request_id": "string"
    }
  ],
  "next_cursor": "string"
}

{
  "code": "string",
  "status": 400,
  "title": "Bad Request",
  "detail": "string",
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}

{
  "code": "string",
  "status": 401,
  "title": "Unauthorized",
  "detail": "string",
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}

{
  "code": "string",
  "status": 403,
  "title": "Forbidden",
  "detail": "string",
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}

{
  "code": "string",
  "status": 422,
  "title": "Unprocessable Entity",
  "detail": "string",
  "errors": [
    {
      "message": "expected length >= 1",
      "location": "body.name"
    }
  ],
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}