Skip to main content
POST
/
v2
/
team.user.remove
RemoveMember
curl --request POST \
  --url https://api.manus.im/v2/team.user.remove \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "team_user_id": "123456"
}
'
{
  "ok": true,
  "request_id": "<string>",
  "user": {
    "email": "<string>",
    "user_name": "<string>",
    "team_user_id": "<string>",
    "delegated_to": "<string>",
    "delegated_profiles": [
      {
        "team_user_id": "<string>",
        "display_name": "<string>",
        "delegated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "original_email": "<string>"
  },
  "cascade_affected": [
    {
      "team_user_id": "<string>",
      "display_name": "<string>",
      "action": "<string>"
    }
  ]
}
Questions or issues? Contact us at api-support@manus.ai.
Irreversible: Hard-deletes the team member’s user record. There is no undo — confirm with your offboarding workflow before calling.
Cascade: Any profiles delegated to this member are returned to the deactivated pool and listed in cascade_affected[]. Inspect team.user.detail first if you need to know which profiles will be reclaimed.Owner cannot be removed: Returns failed_precondition for the team owner.Equivalent to status = REMOVED: team.user.update with status: USER_STATUS_REMOVED performs the same operation by email; this endpoint is the team_user_id-keyed variant and is preferred for IDP integrations that cache the stable id.Protocols: Also callable via Connect RPC. See Protocols.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
team_user_id
string
required

ID of the team member to remove.

Required string length: 1 - 64
Example:

"123456"

Response

Team member removed successfully.

​
ok
boolean
Example:

true

​
request_id
string
​
user
object

Snapshot of the removed user. status is USER_STATUS_REMOVED.

​
cascade_affected
object[]

Profiles delegated to the removed user that were returned to the deactivated pool.