Skip to content
Aether Docs

Open a support ticket

POST
/api/v1/organizations/{orgID}/tickets
curl --request POST \
  --url https://api.aetherplatform.cloud/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "cluster_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "subject": "example", "category": "cluster", "severity": "low", "body": "example" }'

Opens a ticket. The ticket’s initial body is stored as the first message, authored by the caller as a tenant message. severity defaults to low and category to general when omitted. The created_by field is set from the caller’s JWT subject (null for API tokens).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
orgID
required
string format: uuid

Organization UUID.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
cluster_id

Optional cluster this ticket concerns.

string format: uuid
subject
required
string
category

Defaults to general when omitted.

string
Allowed values: cluster networking storage identity billing feature_request general
severity

Defaults to low when omitted.

string
Allowed values: low medium high critical
body
required

The initial message body (stored as the first tenant message).

string

Responses

Section titled “Responses”

201

Section titled “201”

Ticket created.

Media typeapplication/json
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
Example
{
  "category": "cluster",
  "severity": "low",
  "status": "open"
}

401

Section titled “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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

422

Section titled “422”

Request validation failed.

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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}