Skip to content

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.

id
required
string format: uuid

The team’s id.

user_ref
required
integer format: int64

The member’s account ref.

The membership was removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed