API Reference
Agents

Give back purchased agent seats

POST
/v1/agents/seats/release

Lowers purchased_seats so the next renewal bills for fewer seats. Only seats you bought can be released; the plan's tier_seats are not affected.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents/seats/release" \  -H "Content-Type: application/json" \  -d '{    "quantity": 1  }'
{  "purchased_seats": 0}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ]  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ]  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ]  }}

Buy additional concurrent agent seats POST

Charges the wallet immediately and raises `seats_total` by `quantity`. Seats are a monthly subscription: they renew from the wallet, and a failed renewal sets `past_due` rather than removing capacity silently. Requires a writer role — buying capacity spends money.

List broadcasts with per-row funnel + spend GET

Next Page