Remove a team member from team

Removes a member from the team by their ID. This action cannot be undone.

Removing a user with the admin role is not permitted via the API.

DELETE https://betterstack.com/api/v2/team-members/{id}

URL parameters

required string

The ID of the team member to remove.

Query parameters

team_name

string

Required if using a global API token to specify the team.

Headers

Authorization

required string

Bearer $TOKEN

204

The team member was successfully removed.

404

The team member with the specified ID was not found.

Response body

{
  "errors": "Resource type user with id = 999 was not found"
}

403

Removing an admin is forbidden.

Response body

{
  "errors": "Removing admins is not allowed via API"
}

Example

Copied!

curl --request DELETE \
  --url "https://betterstack.com/api/v2/team-members/102" \
  --header "Authorization: Bearer $TOKEN"