Developer APIResourcesRoles

Copy a custom role

Creates a copy of a custom collaborator role with the ability to change the folders accessible by the role. The folder IDs can be obtained with the GET folders endpoint.

Path parameters

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. Folder IDs are copied directly from the source if you don't provide specific folder IDs.

Response

Details of a specific role
idinteger or null
The unique identifier of the role.
namestring or null
The name of the role.
inheritableboolean or null
Indicates whether the role is inheritable.
folder_idslist of strings or null
Array of folder IDs associated with the role.
created_atstring or null
The timestamp when the role was created.
updated_atstring or null
The timestamp when the role was last updated.

Errors