Skip to main content
DELETE
Remove team member

Overview

Remove a user from a tenant. This only removes the user’s association with the tenant - the user account itself is not deleted and they can still be members of other tenants.

Authorization

  • User must be authenticated with a valid Bearer token
  • User must have ADMIN role in the specified tenant

Behavior

  • Removes the user-tenant relationship (deletes the pivot record)
  • User account remains active in the system
  • User can still access other tenants they belong to
  • Does not affect the user’s data in other tenants

Example Usage

Error Responses

User Not Found (404)

Not a Member (400)

Important Notes

  • Removing a user does not delete their account
  • The user can be re-added to the tenant later
  • Consider implementing a “leave tenant” endpoint for self-service removal

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tenantId
integer
required

Tenant ID

userId
integer
required

Response

200

Member removed