integrations

Give a case a free pro upgrade (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/cases/{caseId}/pro-upgrade
Access token

Turns on pro for the case and grants its AI tokens at once, recorded as a comped pro-upgrade billing item that is never charged. Returns 404 for an unknown case or when its organization has no billing profile, and 409 when the case already has a pro-upgrade item (comp that item instead). Super admin only.

Path parameters

  • caseId string Required

    Id of the case

application/json

Body Required

  • comped boolean Required

    Value is true.

  • reason string Required

    Required audit reason — persisted on the BillingEvent

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • id string Required
      • caseId string Required
      • skuKey string Required
      • status string Required
      • description string Required
      • quantity number Required
      • unitAmountCents number Required
      • amountCents number Required
      • informational boolean Required
      • listAmountCents number | null Required
      • adminNote string | null Required
    • statusCode number Required
    • timestamp string(date-time) Required
POST /admin/cases/{caseId}/pro-upgrade 
curl \
 --request POST 'http://api.example.com/admin/cases/{caseId}/pro-upgrade' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "comped": true,
  "reason": "string"
}'
Request examples 
{
  "comped": true,
  "reason": "string"
}
Response examples (200) 
{
  "data": {
    "id": "65a1b2c3d4e5f6a7b8c9d0e9",
    "caseId": "65a1b2c3d4e5f6a7b8c9d0e2",
    "skuKey": "addon.shipping",
    "status": "PENDING",
    "description": "Admin add-on: addon.shipping",
    "quantity": 1,
    "unitAmountCents": 2500,
    "amountCents": 2500,
    "informational": false,
    "listAmountCents": 42.0,
    "adminNote": "string"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}