Users

Set User's Project Role

Creates or updates a user's project role.

:::info

Available for organization admins only.

:::

put/api/v2/userRoles/{userID}/projects/{projectID}

Request

Base URL: https://app.coalescesoftware.io
URL: https://app.coalescesoftware.io/api/v2/userRoles/{userID}/projects/{projectID}
Auth: HTTP bearer

projectRole'member' | 'admin' | 'contributor' | 'architect' required

A single user's role information

userIDstring required

The user ID.

organizationRolestring

User's organization role. Excluded when requesting specific environments/projects if the role lacks project permissions.

projectRolesobject

Returns a dictionary mapping project IDs to user roles.

Example:

"45a4f214-8a3e-48c7-8c6b-ff284798de4c": "admin"

Format: projectID: userRole

Note: Only includes projects where the user has a role. Environment-only roles are excluded.

environmentRolesobject

Returns a dictionary mapping environment IDs to user roles.

Example:

"33": "admin"

Format: environmentID: userRole

Note: Only includes environments where the user has a role.

No recorded changes to this operation across all 1 revision of this API.