accounts

Set Role

Assigns a role slug to one account (ResourceAuth manage). Rejects with 403 forbidden if the change would escalate an account to admin beyond what the caller may grant, and with 400 unknown_role if the slug does not exist as a role in scope. Role changes take effect immediately — role is read fresh from the account row on every request, never trusted from an old JWT claim.

put/accounts/{id}/role

Request

  • Base URL: https://api.instruxi.dev/api/v1/enforcer
  • URL: https://api.instruxi.dev/api/v1/enforcer/accounts/{id}/role
  • Auth: one of:
    • API key in header Authorization
    • API key in header X-API-Key

Path parameters

idstring required

id

Request body

rolestring

role slug

Response

OK

successboolean

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.