List support tickets

GET

/api/v1/organizations/{orgID}/tickets

curl --request GET \
  --url 'https://api.aetherplatform.cloud/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tickets?limit=50' \
  --header 'Authorization: Bearer <token>'

Lists the organization’s support tickets, newest first.

Authorizations

• bearerApiToken
• bearerPortalJwt

Parameters

Path Parameters

orgID

required

string format: uuid

Organization UUID.

Query Parameters

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.

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"
    }
  ]
}

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

status_url

The platform status page (https://status.aetherplatform.cloud). Present on 5xx answers written by the API’s error writer and on no other; absent, not null, on 4xx.

string format: uri

decline_code

The payment provider’s decline code. Present only on 402 payment_declined; it is its own field and is never folded into message.

string

invoice_id

Present on exactly these errors of the invoice pay and pay/confirm endpoints: 402 payment_declined, 402 payment_method_required, 409 invoice_already_paid, 409 invoice_not_issued, 409 invoice_below_minimum, 409 payment_not_in_flight, and 409 invoice_void when the void invoice was replaced. It is the id of the live invoice, which after a re-issue is the replacement and not the id in the request URL (on 409 invoice_void from pay/confirm it is the replacement’s id). Absent on every other error — 400 (including discount_code_invalid), 403, 404, the discount_* 409s, 409 invoice_void with no replacement (nothing live to name), every 5xx and 503 code — and never null.

string format: uuid

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ],
    "status_url": "https://example.com",
    "decline_code": "example",
    "invoice_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
}

403

Refused by the organization role policy (see Authorization in the API description). error.code is forbidden when the caller is not a member of the organization (or the API token belongs to another organization), insufficient_role when the caller’s organization role is below the operation’s minimum role, and token_not_permitted when the request was authenticated with an API token on an operation API tokens may not use (the API Tokens operations; the handler-gated operations named in the API description: deleting the organization, changing a member’s role or payment_mode, paying an invoice including its confirm step, and discounts; and for a cluster-pinned machine token every operation except the loadbalancer-ips and loadbalancer-vms operations). email_unverified when a portal user’s e-mail address is not verified (see Authentication).

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

status_url

The platform status page (https://status.aetherplatform.cloud). Present on 5xx answers written by the API’s error writer and on no other; absent, not null, on 4xx.

string format: uri

decline_code

The payment provider’s decline code. Present only on 402 payment_declined; it is its own field and is never folded into message.

string

invoice_id

Present on exactly these errors of the invoice pay and pay/confirm endpoints: 402 payment_declined, 402 payment_method_required, 409 invoice_already_paid, 409 invoice_not_issued, 409 invoice_below_minimum, 409 payment_not_in_flight, and 409 invoice_void when the void invoice was replaced. It is the id of the live invoice, which after a re-issue is the replacement and not the id in the request URL (on 409 invoice_void from pay/confirm it is the replacement’s id). Absent on every other error — 400 (including discount_code_invalid), 403, 404, the discount_* 409s, 409 invoice_void with no replacement (nothing live to name), every 5xx and 503 code — and never null.

string format: uuid

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ],
    "status_url": "https://example.com",
    "decline_code": "example",
    "invoice_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
}