List tickets across all orgs

GET

/api/v1/admin/tickets

curl --request GET \
  --url 'https://api.aetherplatform.cloud/api/v1/admin/tickets?status=open&severity=low&category=cluster&limit=50' \
  --header 'Authorization: Bearer <token>'

Lists support tickets across every organization, newest first, for platform staff. Narrow the result with the optional status, severity, category, org_id, and assigned query parameters. Requires the platform-admin realm role.

Authorizations

• bearerApiToken

Parameters

Query Parameters

status

string

Allowed values: open in_progress waiting resolved closed

severity

string

Allowed values: low medium high critical

category

string

Allowed values: cluster networking storage identity billing feature_request general

org_id

string format: uuid

Restrict to a single organization.

assigned

string

unassigned for tickets with no assignee, or a user UUID for tickets assigned to that staff member. Omit for any.

cursor

string format: uuid

Opaque cursor (a UUID) for pagination; pass back the prior page’s next_cursor.

limit

integer

default: 50 >= 1 <= 100

Maximum number of items per page (1-100, default 50).

Responses

200

A page of tickets across all orgs.

Media typeapplication/json

object

items

required

Array<object>

object

id

required

string format: uuid

org_id

required

string format: uuid

cluster_id

Optional cluster this ticket concerns.

string | null format: uuid

subject

required

string

category

required

string

Allowed values: cluster networking storage identity billing feature_request general

severity

required

string

Allowed values: low medium high critical

status

required

string

Allowed values: open in_progress waiting resolved closed

created_by

JWT subject of the opener; null for API-token requests.

string | null format: uuid

assigned_to

string | null format: uuid

first_response_at

Set when the first provider message is posted.

string | null format: date-time

resolved_at

Set when the ticket enters resolved; cleared only when a resolved ticket is reopened (to open/in_progress); preserved on close.

string | null format: date-time

created_at

required

string format: date-time

updated_at

required

string format: date-time

next_cursor

string | null

Example

{
  "items": [
    {
      "category": "cluster",
      "severity": "low",
      "status": "open"
    }
  ]
}

400

Invalid query — malformed org_id, or assigned that is neither unassigned nor a user UUID.

Media typeapplication/json

object

error

required

object

code

required

A stable, machine-readable error code.

string

message

required

string

details

Array<object>

object

field

required

string

code

required

string

message

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

401

Missing or invalid credentials.

Media typeapplication/json

object

error

required

object

code

required

A stable, machine-readable error code.

string

message

required

string

details

Array<object>

object

field

required

string

code

required

string

message

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

403

The credential was accepted but lacks the required role or access (e.g. a non-platform-admin calling an /api/v1/admin endpoint).

Media typeapplication/json

object

error

required

object

code

required

A stable, machine-readable error code.

string

message

required

string

details

Array<object>

object

field

required

string

code

required

string

message

required

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}