Switch the workspace storage tier

Upgrades debit the price delta from the wallet at flip time and emit a storage.tier_changed event. Downgrades flip immediately and are NOT refunded. Same-tier PUTs are a no-op. Idempotency-Key header dedupes the wallet debit on retries.

Authorization

bearerAuth

AuthorizationBearer <token>

Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the platform keyring. Carries workspace_id and scopes claims; revoked via the platform deny-list.

In: header

Header Parameters

Idempotency-Key?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tier_gb*integer

Value in

Response Body

`application/json`

curl -X PUT "https://example.com/v1/storage/tier" \  -H "Content-Type: application/json" \  -d '{    "tier_gb": 1  }'

{  "tier_gb": 1,  "log_retention": "string",  "used_bytes": 0,  "breakdown": {    "recordings_bytes": 0,    "logs_bytes": 0,    "other_bytes": 0  },  "price_minor": 0,  "currency": "string",  "updated_at": "2019-08-24T14:15:22Z"}

Empty