Update Business Role

PUT

https://api.projectmanager.com/api/data/security/businessroles/:roleId

Send property change sets using the same pattern as other workspace batch-update APIs.

For permissions, include a permissions property with a partial or full permissions object; omitted keys are merged with the current role. Keys may use the same names as GET permissions (e.g. editUsers) or RetrieveMe / POST-create style (e.g. editUser). The response body matches create when successful.

Send property change sets using the same pattern as other workspace batch-update APIs. For permissions, include a permissions property with a partial or full permissions object; omitted keys are merged with the current role. Keys may use the same names as GET `permissions` (e.g. `editUsers`) or RetrieveMe / POST-create style (e.g. `editUser`). The response body matches create when successful.

Authentication

AuthorizationBearer

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

Path parameters

roleIdstringRequiredformat: "uuid"

Business role identifier.

Request

List of property name and value pairs to apply.

propertystringOptional

Field to change: name, description, or permissions.

valueany or nullOptional

New value for the field; for permissions, a JSON object in the role permissions matrix shape.

idstring or nullOptionalformat: "uuid"

Optional identifier when the change targets a nested or keyed item.

Response

Success

errorobject or nullOptional

If the API call failed, this will contain information about the error that occurred.

successbooleanOptionalRead-only

True if the API call succeeded; false otherwise.

hasErrorbooleanOptionalRead-only

True if the API call failed.

statusCodeenumOptional

The HTTP code of the response.

dataobjectOptional

Workspace business role returned by the data API security endpoints (list/update responses and create response).

Authentication

Path parameters

Headers

Request

Response