integrations

Remove a user from an organization (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
POST /admin/organization/remove-user-from-org
Access token

Removes the membership of the user given by userId or email from the organization given by orgId or orgName; the user account itself is kept. Returns 404 for an unknown organization or user and 400 when the user is not a member. Super admin only.

application/json

Body Required

  • email string

    required if userId not sent

  • userId string

    required if email not sent

  • orgId string

    required if orgName not sent

  • orgName string

    required if orgId not sent

  • deleteUser boolean

    Default value is false.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • message string Required
      • isSuccess boolean Required
    • statusCode number Required
    • timestamp string(date-time) Required
POST /admin/organization/remove-user-from-org 
curl \
 --request POST 'http://api.example.com/admin/organization/remove-user-from-org' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "email": "string",
  "userId": "string",
  "orgId": "string",
  "orgName": "string",
  "deleteUser": false
}'
Request examples 
{
  "email": "string",
  "userId": "string",
  "orgId": "string",
  "orgName": "string",
  "deleteUser": false
}
Response examples (200) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}