List order drafts

When called with a workspace context (token-implied or Akua-Context), returns order drafts for offers in that workspace (workspace members only; field_values omitted). Without a workspace context, returns the caller’s own order drafts across workspaces. Filterable by ?offer= and ?status=.

GET /order_drafts

List order drafts

cURL

curl --request GET \
  --url https://api.akua.dev/v1/order_drafts \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "<string>",
      "offer_id": "<string>",
      "cluster_ready": true,
      "server_joined": true,
      "payment_completed": true,
      "created_at": 1,
      "updated_at": 1,
      "etag": "<string>",
      "ttl_expires_at": 1,
      "user_id": "<string>",
      "customer_email": "<string>",
      "workspace_id": "<string>",
      "cluster_id": "<string>",
      "current_checkout_session": {
        "id": "cs_test_...",
        "draft_revision": 1,
        "url": "<string>",
        "expires_at": 1
      },
      "install_operation_id": "<string>",
      "order": {
        "id": "<string>",
        "stripe_checkout_id": "<string>",
        "draft_revision": 1,
        "committed_at": 1
      },
      "delivery": {
        "id": "<string>",
        "urls": [
          {
            "route_key": "<string>",
            "hostname": "<string>",
            "url": "<string>",
            "updated_at": 1,
            "error": "<string>",
            "last_observed_at": 1
          }
        ],
        "install_id": "<string>",
        "install_operation_id": "<string>",
        "started_at": 1,
        "completed_at": 1
      },
      "field_values": {}
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

Authorization · string · header · required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

akua-context · string

Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens — a workspace-owned token implies its workspace.

Required string length: 1 - 53

Example:

"ws_j572abc123def456"

Query Parameters

cursor · string

Pagination cursor from a previous response's next_cursor.

limit · integer · default: 50

Items per page (1-100, default 50)

Required range: 1 <= x <= 100

Example:

50

offer · string

Filter by offer ID

Required string length: 1 - 56

Example:

"offer_j572abc123def456"

status · enum<string>

Wizard phase. Driven by the order draft actor; mirrored on every patch to the row so reactive UIs render one column. done and terminated are terminal.

Available options: auth, workspace, compute, compute_bootstrap, configure, payment, install, done, cleaning_up, terminated

Response

200

application/json

List of order drafts

data · object[] · required

Show child attributes

has_more · boolean · required

True if more items exist after this page.

next_cursor · string | null · required

Opaque cursor for the next page, or null if no more pages.