Information
- OpenAPI version:
3.1.0
Overview
Aether API 1.0.0
Section titled “Aether API 1.0.0”The Aether HTTP API for managing organizations, Kubernetes clusters, node pools, container registries, and billing on the Aether platform.
Base URL
All endpoints are served under https://api.aetherplatform.cloud. Versioned
routes live under the /api/v1 prefix.
Authentication
Requests authenticate with an API token of the form aether_<hex>, sent in the
Authorization header as a Bearer credential:
Authorization: Bearer aether_0123456789abcdef...Tokens are created per organization (see the API Tokens endpoints) and the raw
secret is shown only once, at creation time. Unauthenticated requests receive
401.
Rate limiting
Requests are rate-limited to 100 requests per minute per key (token-bucket
with a small burst allowance). Exceeding the limit returns 429.
Pagination
List endpoints use opaque cursor pagination via query parameters:
?cursor=<UUID>&limit=<N>limit defaults to 50 and is capped at 100. The response envelope carries
the items plus a next_cursor field; when next_cursor is absent there are no
further pages. Pass the returned next_cursor value back as cursor to fetch
the next page.
Errors
Errors are returned as a JSON object with an error member containing a stable
code, a human-readable message, and (for validation failures) a details
array.
Authentication
Section titled “ Authentication ”bearerApiToken
Section titled “bearerApiToken ”An Aether API token of the form aether_<hex>, sent as Authorization: Bearer <token>.
Security scheme type: http