Change members' organization roles (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

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

PATCH /organization/{orgId}/update-user-role

Access token

Sets the organization role of each listed user. Requires an org admin or owner and an active plan (403 otherwise). Users who are not members are skipped without an error.

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
- accessLevel string Required
  
  Values are user, client, employee, billing, full_access, admin, owner, or member. Default value is member.

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}/update-user-role

curl \
 --request PATCH 'http://api.example.com/organization/{orgId}/update-user-role' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "users": [
    {
      "id": "string",
      "accessLevel": "member"
    }
  ]
}'

Request examples

{
  "users": [
    {
      "id": "string",
      "accessLevel": "member"
    }
  ]
}

Response examples (200)

{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}