Developer docs
Remove a teammate
Remove a teammate from the account, or cancel a pending invitation, and free the seat. A removed teammate loses access to the account at once, and the API keys and connected apps they set up for it stop working. Transfers they added stay in the account. Only the account owner's API keys and connected apps can remove, while the plan includes team seats.
DELETE
https://uetr.ai/api/v1/team/members/{member_id}- MCP tool:
remove_team_member - Access: a key or connection with read and write access
- Only the account owner's keys and connections
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
member_id | path | string (uuid) | Yes | The teammate's seat id, from list_team_members. |
Response
| Field | Type | Required | Description |
|---|---|---|---|
removed | boolean | Yes | |
member_id | string (uuid) | Yes |
Example
curl -X DELETE "https://uetr.ai/api/v1/team/members/6f1c2b9e-3d4a-4e8f-9b7c-1a2d3e4f5a6b" \ -H "Authorization: Bearer $UETR_API_KEY"
The answer:
{
"removed": true,
"member_id": "6f1c2b9e-3d4a-4e8f-9b7c-1a2d3e4f5a6b"
}Refusals
Besides the access refusals every call can meet, this call can answer:
read_only_credential(403): Read-only key or connection.machine_writes_disabled(503): Changes are switched off.not_permitted(403): Not permitted.seat_not_active(409): Seat no longer active.member_removal_failed(503): Teammate not removed.