Developer APIResourcesRoles

Update a custom role

Updates the projects accessible to a custom collaborator role. You can set the privilege to all projects or specific projects by their folder IDs. 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.
all_foldersenumRequired

Indicate whether the role has access to all the projects. Possible values are trueor false. You must set this field to false if you specify folder_ids.

Allowed values:
folder_idslist of stringsOptional
Array of folder IDs.

Response

Details of a specific role with privileges
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 integers 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.
privilegesobject or null
An object containing the privileges associated with the role.

Errors