Updates a role in the caller's organization.
Token types: APP, USER | Required scopes: role:write:org
Authorizations
Application (M2M) OAuth2 access token (client credentials).
Headers
ID of the organization to scope this operation to. When omitted, the role is updated in the caller's own organization. Must be a valid non-empty UUID. Present but empty or malformed values return 400.
Path Parameters
The ID of the role to update.
Body
Cancellation token.
Two states accepted: absent = leave unchanged, value = set (must be a ranked type the owning org holds). Clearing to null is rejected, roles cannot become unscoped.
BANK, EMBEDDED, PLATFORM, TRANSACTOR, VERTICAL_SOFTWARE_PROVIDER, null Three states: absent = leave unchanged, null = clear, value = set.
Two states accepted: absent = leave unchanged, value = set (must be at least 5000). Clearing to null is rejected.
Response
Role updated successfully.
bank:admin, embedded:admin, embedded:bookkeeper, embedded:employee, embedded:finance_admin, platform:admin, vsp:admin