Embedded APIResourcesRoles

Copy a custom role

Creates a copy of a custom role in a customer workspace with the ability to change the folders accessible by the role. The folder IDs can be obtained with the GET folders API endpoint (/api/managed_users/:managed_user_id/folders).

Path parameters

managed_user_idstringRequired

Embedded customer ID (external ID). The External ID must be URL encoded and prefixed with an E. For example, EA2300.

idintegerRequired

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired
Name of the new custom role.
folder_idslist of stringsOptional
Array of project folder IDs to override. The source folder IDs are copied if left blank.

Response

Success response
idinteger or null
Unique identifier of the role.
namestring or null
Name of the role.
inheritableboolean or null
Indicates whether the role is inheritable.
folder_idslist of strings or null
List of folder IDs associated with the role.
created_atdatetime or null
Timestamp when the role was created.
updated_atdatetime or null
Timestamp when the role was last updated.

Errors