Skip to main content
DELETE
/
organizations
/
{id}
/
members
/
{memberId}
Remove a member (owner/admin only)
curl --request DELETE \
  --url http://sandbox.mintlify.com/organizations/{id}/members/{memberId} \
  --header 'Authorization: Bearer <token>'
Removes a member from the organization.

​
Permissions

User must be owner or admin to remove members.

​
Restrictions

  • Owner cannot be removed - This is enforced at the business logic layer
  • Cannot remove yourself if you’re the only admin
  • Removed members lose all access to organization resources

​
What Happens

  • Member is removed from organization
  • Access to organization resources is revoked
  • Member’s API keys and tokens are invalidated

​
Example

curl -X DELETE http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/members/123 \
  -H "Authorization: Bearer <token>"

​
Events Published

  • MemberRemovedEvent - Triggers cleanup and audit log

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required
​
memberId
string
required

Response

Member removed successfully from the organization.