Update user role in organization
PUT
/api/v1/users/{id}/organizations/{organizationId}/role
const url = 'http://localhost:3000/api/v1/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/role';const options = { method: 'PUT', headers: {'X-API-Key': '<X-API-Key>', 'Content-Type': 'application/json'}, body: '{"roleId":"550e8400-e29b-41d4-a716-446655440002"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url http://localhost:3000/api/v1/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/role \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <X-API-Key>' \ --data '{ "roleId": "550e8400-e29b-41d4-a716-446655440002" }'Updates a user’s role in an organization. Requires USERS_WRITE or ORG_WRITE permission. Cannot change own role or escalate beyond own role level.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
User UUID
organizationId
required
string format: uuid
Organization UUID
Request Body required
Section titled “Request Body required ” Media type application/json
object
roleId
required
New role UUID to assign to the user
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440002Responses
Section titled “ Responses ”User role updated successfully
Invalid input data
Unauthorized
Forbidden - Cannot change own role or escalate privileges
User, organization, or role not found