List admin jobs.

GET

/api/admin/jobs

Code sample: Shell / cURL

curl --request GET \
  --url 'https://auth.example.com/api/admin/jobs?limit=20&sort=created_at' \
  --header 'Authorization: Bearer <token>'

Lists tenant admin jobs with cursor-based pagination. The handler rejects page/page_size, validates limit, cursor, sort, and status/job_type filters, and returns data plus has_more and next_cursor metadata.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Query Parameters

limit

integer

default: 20 >= 1 <= 100

cursor

string

sort

string

Allowed values: created_at -created_at updated_at -updated_at status -status job_type -job_type

filter

string

Comma-separated filters for status and job_type, for example status:pending.

Responses

200

Cursor-paginated job list response.

Media type application/json

object

data

required

Array<object>

object

job_id

required

string

type

required

string

status

required

string

Allowed values: pending processing completed failed partial_failure

progress

required

object | null

created_by

required

string

created_at

required

string | null format: date-time

updated_at

required

string | null format: date-time

started_at

required

string | null format: date-time

completed_at

required

string | null format: date-time

estimated_completion

required

string | null format: date-time

next_run_at

required

string | null format: date-time

attempts

required

integer

max_attempts

required

integer

dead_lettered_at

required

string | null format: date-time

error_code

string

error_message

string

parameters

object

key

additional properties

key

additional properties

pagination

required

object

has_more

required

boolean

next_cursor

string

key

additional properties

key

additional properties

Example

{
  "data": [
    {
      "job_id": "018f3f7c-85b0-7c5d-a6b6-1c3a6e6b9e01",
      "type": "users/import",
      "status": "pending",
      "progress": {
        "total": 0,
        "processed": 0,
        "succeeded": 0,
        "failed": 0,
        "stage": "queued"
      },
      "created_by": "admin_123",
      "created_at": "2026-02-01T00:00:00.000Z",
      "updated_at": "2026-02-01T00:00:00.000Z",
      "started_at": null,
      "completed_at": null,
      "estimated_completion": "2026-02-01T00:05:00.000Z",
      "next_run_at": null,
      "attempts": 0,
      "max_attempts": 3,
      "dead_lettered_at": null
    }
  ],
  "pagination": {
    "has_more": false
  }
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}