APIPricing

End seat assignment

End a seat assignment; only valid while the row is still open. For a live row this stops the seat being counted, effective now. For a not-yet-started (scheduled) row it cancels the schedule and re-extends the assignment it superseded, so the prior plan resumes for the months it would have covered.

POST
/seat-assignments/{id}/end

End a seat assignment; only valid while the row is still open. For a live row this stops the seat being counted, effective now. For a not-yet-started (scheduled) row it cancels the schedule and re-extends the assignment it superseded, so the prior plan resumes for the months it would have covered.

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

Path Parameters

id*string
Formatuuid

Response Body

The request has succeeded.

application/json
  1. response

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

id*uuid

Omitted assigns the org default seat.

Formatuuid
user_id?uuid

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
Example Request
curl -X POST 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/seat-assignments/497f6eca-6276-4993-bfeb-53cbbbba6f08/end'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",  "provider": "claude",  "plan": "string",  "effective_from": "2019-08-24T14:15:22Z",  "effective_to": "2019-08-24T14:15:22Z"}