v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Custom Roles

Switch to Custom Roles

Update the organization's Custom Roles switch status. This endpoint allows you to enable or disable the Custom Roles feature for the organization, provided the organization is allowed to make this change.

post/org/{org_id}/switch_to_custom_roles

Path parameters

org_idinteger required

Unique ID of the organization to which the resource belongs. Only PROVIDER users can access resources from a different organization than their own. If you are not a PROVIDER, this will default to the ID of your organization.

Request body

switch_to_custom_rolesboolean required

Whether to switch to Custom Roles (true) or revert to standard roles (false)

Example request

{
  "switch_to_custom_roles": true
}

Response

Successfully updated Custom Roles switch status

status'success' required

Request status

org_idinteger required

Unique identifier for the organization you want to switch. Only PROVIDER users can use this field. If you are not a PROVIDER, this will default to the ID of your organization.

Example response

{
  "status": "success",
  "org_id": 123
}