Update member role
Update a member's role
userId is the userId field from the member list. A key cannot change its own principal's role. Organization owners are not editable here. Assigning admin - or changing anyone who currently IS an admin - additionally requires the caller to act as an organization owner or admin.
Path Parameters
The member's user id.
"admin" | "editor" | "viewer"Response Body
curl -X PATCH "https://lynx-api.trulyinbox.com/v2/workspaces/0/members/0" \ -H "Content-Type: application/json" \ -d '{ "role": "admin" }'{
"data": {
"userId": 0,
"email": "string",
"name": {},
"role": "owner",
"isOrgOwner": true,
"joinedAt": "2019-08-24T14:15:22Z"
},
"meta": {
"request_id": "req_2f1c…",
"timestamp": "2019-08-24T14:15:22Z"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"details": {},
"retry_after": 34
},
"meta": {
"request_id": "req_2f1c…",
"timestamp": "2019-08-24T14:15:22Z"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"details": {},
"retry_after": 34
},
"meta": {
"request_id": "req_2f1c…",
"timestamp": "2019-08-24T14:15:22Z"
}
}Invite a memberPOST
Emails an invitation and returns the pending invite. The invitee becomes a member only once they accept, so they will not appear in the member list yet. Inviting someone as `admin` additionally requires the calling key to act as an organization owner or admin - a workspace key (`ti_ws_`) never does, so use a personal key for that.
Remove a memberDELETE
Revokes the membership. The user keeps their account and any other workspaces they belong to; their email accounts stay with the workspace. Organization owners cannot be removed here - they hold implicit access to every workspace and are managed at the organization level. Removing a member whose role is `admin` additionally requires the caller to act as an organization owner or admin. Passing the calling key's own principal is the "leave workspace" action, which will revoke that key's access. Returns 204 with no body.