Change workspace subscription tier

Schedules a subscription tier change for the workspace.

POST /workspaces/{id}/subscription:changeTier

Change workspace subscription tier

cURL

curl --request POST \
  --url https://api.akua.dev/v1/workspaces/{id}/subscription:changeTier \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'if-match: <if-match>' \
  --data '
{
  "tier": "<string>"
}
'

202

{
  "operation_id": "<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"

if-match · string · required

The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.

Required string length: 1 - 256

Example:

"42"

Path Parameters

id · string · required

Workspace ID

Required string length: 1 - 53

Body

application/json

tier · string · required

Response

202

application/json

Tier change accepted

operation_id · string · required

Required string length: 1 - 53