Patch a specified Role

PATCH {{baseUrl}}/roles/:id

This API updates an existing role using JSON Patch syntax.

The following fields are patchable:

• name
• description
• enabled
• owner
• accessProfiles
• membership
• requestable
• accessRequestConfig
• revokeRequestConfig
• segments

A token with API, ORGADMIN, ROLEADMIN, or ROLESUBADMIN authority is required to call this API. In addition, a token with ROLESUBADMIN authority may only call this API if all access profiles included in the role are associated to Sources with management workgroups of which the ROLE_SUBADMIN is a member.

The maximum supported length for the description field is 2000 characters. Longer descriptions will be preserved for existing roles, however, any new roles as well as any updates to existing descriptions will be limited to 2000 characters.

When you use this API to modify a role's membership identities, you can only modify up to a limit of 500 membership identities at a time.

Body PARAM

HEADERS

Content-Type

Accept

RESPONSES

status