Remove a user from a team
DELETE /teams/{id}/members/{user_ref}
Removes an account from a team’s direct members.
You need to be signed in with teams.admin or system.admin
granted globally; a grant within the team isn’t enough. A user_ref
that isn’t a whole number in range, or an id that isn’t a UUID,
gets a plain-text 400 before sign-in is checked.
The membership is matched exactly, without looking up the team or the account, so a membership on a deleted team, or one for a ref with no account, can be removed. When there’s none, including on a second request, the answer is 404.
Removing a membership ends only what membership gives. Role assignments, grants given within the team, follows and the account’s own work stay, and other access the account has may still let it read the same content. Nobody is notified, and no audit entry is recorded. Server errors get a plain-text 500.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The team’s id.
The member’s account ref.
Responses
Section titled “ Responses ”The membership was removed.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed