Update existing role

put/api/usermanagement/v1/organizations/{orgId}/roles/{roleId}

Updates an existing role within an organization with new permissions, resources, or other settings. This may require approval for critical changes.

Path Parameters

  • orgIdstringRequired
  • roleIdstring<uuid>Required

Request Body

name string required
Min length: >= 0 characters
Max length: <= 256 characters
enterprises object required
allEnterprises boolean required
enterprises array[string] required
enterpriseNames array[string]
resources array[object] required
Resource access configuration for a role
enterpriseId string required
The public ID of the enterprise
Example: 59cd72485007a239fb00282ed480da1f
resourceType string required
The type of resource
Example: wallet
scope string required
The scope of resource access
Allowed values: ALL LIMITED
resources array[string] required
List of external resource IDs
Example: ["63c86bf4555aba000652d5c59aff2866"]
permissions object required
Permission configuration for a role
allPermissions boolean required
Indicates if the role has access to all permissions
Example: false
permissions array[string] required
List of specific permissions for the role

200 Response

202 Response

400 Response

403 Response

404 Response