integrations

Update organization members

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
PATCH /organization/{orgId}/user
Access token

Updates each listed member's organization role and/or their name and login email. Name and email change on the user account itself, not only in this organization, so they can be changed only for a member who belongs to no other organization (403 otherwise, and nothing in the request is applied). Requires an org admin or owner and an active plan (403 otherwise). Returns 400 when an entry has none of role, name or email or the new email belongs to another account, and 404 when a user is not a member.

Path parameters

  • orgId string Required

    Id of the organization

application/json

Body Required

Request body

  • users array[object] Required
    Hide users attributes Show users attributes object
    • id string Required
    • role string

      Values are user, client, employee, billing, full_access, admin, owner, or member.

    • name string

      Minimum length is 3, maximum length is 200.

    • email string

      Maximum length is 100.

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
PATCH /organization/{orgId}/user 
curl \
 --request PATCH 'http://api.example.com/organization/{orgId}/user' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "users": [
    {
      "id": "string",
      "role": "user",
      "name": "string",
      "email": "string"
    }
  ]
}'
Request examples 
{
  "users": [
    {
      "id": "string",
      "role": "user",
      "name": "string",
      "email": "string"
    }
  ]
}
Response examples (200) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}