v171

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0726249111.7 MB
People

Update a person

Updates the roles and group assignments of a workspace member. Omitted fields keep their current values.

patch/v2/people/{person_id}

Path parameters

person_idstring required

Person ID to update.

Request body

rolesstring[]

Replacement role list. Leave empty to clear all roles.

groupsstring[]

Replacement group list. Leave empty to clear all groups.

clear_rolesboolean

Explicitly clear all roles. Set to true when sending an empty roles array.

clear_groupsboolean

Explicitly clear all groups. Set to true when sending an empty groups array.

Response

OK