SecureAuth Agent Authority
secureauth.com
APIPricing

Assign seat

Assign a user (or the org default) to a provider subscription plan.

POST
/seat-assignments

Assign a user (or the org default) to a provider subscription plan.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

manage_seat_pricing

Request Body

application/json
  1. body

A user's (or the org default's) assignment to a provider subscription plan.

user_id?string

Omitted assigns the org default seat.

Formatuuid
provider*LLMProvider

LLM telemetry provider.

Value in"claude""codex""gemini""copilot"
plan*string
Length1 <= length <= 100
effective_from?string
Formatdate-time

Response Body

The request has succeeded and a new resource has been created as a result.

application/json
  1. response

A user's (or the org default's) assignment to a provider subscription plan.

id*string
Formatuuid
user_id?string

Omitted assigns the org default seat.

Formatuuid
provider*LLMProvider

LLM telemetry provider.

Value in"claude""codex""gemini""copilot"
plan*string
Length1 <= length <= 100
effective_from?string
Formatdate-time
effective_to?string
Formatdate-time
curl -X POST "https://example.com/seat-assignments" \  -H "Content-Type: application/json" \  -d '{    "provider": "claude",    "plan": "string"  }'
{  "id": null,  "user_id": null,  "provider": "claude",  "plan": "string",  "effective_from": "2019-08-24T14:15:22Z",  "effective_to": "2019-08-24T14:15:22Z"}

List seat assignments GET

List seat assignments for the org. Seats are low-cardinality, so this returns the full set unpaginated.

Delete seat assignment DELETE

Hard-delete a seat assignment. A live row stops being counted; deleting a scheduled row cancels it and the assignment it superseded resumes for those months.