Skip to content
StraventaDocs

Remove a team member from the tenant

Soft-removes the membership (sets `active=false`, revokes assignments). Cannot remove the last `merchant_owner`. Caller must hold `tenant.team.write`. Phase3 / T013.

DELETE
/v1/admin/team/{memberId}

Soft-removes the membership (sets active=false, revokes assignments). Cannot remove the last merchant_owner. Caller must hold tenant.team.write. Phase3 / T013.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT Bearer access token. Clock skew tolerance is ±60 seconds.

In: header

Path Parameters

memberId*string

Membership UUID (NOT user_id) — server resolves user via memberships lookup.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/admin/team/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{
  "error": "unauthenticated",
  "message": "missing or invalid bearer token",
  "request_id": "req_01abc123"
}
{
  "error": "permission_denied",
  "message": "caller does not hold the required permission",
  "request_id": "req_01abc124"
}
{
  "error": "not_found",
  "message": "the requested resource was not found",
  "request_id": "req_01abc125"
}
Empty

Was this page helpful?