Update Site Member Role

Update a site member's role. On a site with Site-specific access enabled, the member must already hold access to this site — grant it first with `POST`. On a site open to the whole workspace, this call sets a per-site role for the first time. To update by email address instead of by ID, see [Update Site Member Role (by email)](/data/reference/enterprise/site-access/update-member-role-by-email). <Warning title="Enterprise Only">This endpoint requires an Enterprise workspace.</Warning> Required scope | `site_access:write`

Authentication

AuthorizationBearer

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

Path parameters

site_idstringRequiredformat: "objectid"
Unique identifier for a Site
member_idstringRequiredformat: "objectid"
Unique identifier for a Member

Request

This endpoint expects an object.
siteRoleenumRequired
The Site Role to assign
siteRoleIdstringOptionalformat: "objectid"

ID of the custom Site Role to assign. Required when siteRole is custom, and rejected with any other siteRole. Rejected if the id doesn’t name a custom Site Role belonging to this workspace.

Response

Request was successful
idstringformat: "objectid"
Unique identifier for the Member
rolesobject
Roles the Member holds
emailstringOptional
Email address of the Member
firstNamestringOptional
First name of the Member
lastNamestringOptional
Last name of the Member

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error