Limits and tiers
Assign a user's limit tier (audited; admin)
Assigns a user to a limit tier and answers with the tier it replaced.
POST
/v1/users/{userId}/tierAssigns a user to a limit tier and answers with the tier it replaced. Requires limits:manage and a machine or staff principal; a user token is refused admin_only (403). An unknown tier gives invalid_request (400) and an unknown user user_not_found (404). Audited.
Authorization
bearerAuth AuthorizationBearer <token>
A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Path Parameters
userId*string
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/tier" \ -H "Content-Type: application/json" \ -d '{ "tier": "string" }'{ "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "tier": "string", "previous": "string"}