Get an organization's storage by case

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"
  }
}

GET /organization/{orgId}/storage-stats

Access token

Returns the total storage used by the organization's cases and a per-case breakdown, largest first, counting only cases that are not archived or deleted, optionally limited to caseIds. Requires a role in the organization (403 otherwise).

Path parameters

orgId string Required

Query parameters

caseIds array[string]

Filter by case ids

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  totalOrgUsagesInBytes number Required
  
  cases array[object] Required
  
  Hide cases attributes Show cases attributes object
  
  caseId string Required
  
  caseName string Required
  
  caseCreatedAt string(date-time) Required
  
  usagesInBytes number Required
- statusCode number Required
- timestamp string(date-time) Required

GET /organization/{orgId}/storage-stats

curl \
 --request GET 'http://api.example.com/organization/{orgId}/storage-stats' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "totalOrgUsagesInBytes": 1073741824,
    "cases": [
      {
        "caseId": "65a1b2c3d4e5f6a7b8c9d0e1",
        "caseName": "Smith v. Jones",
        "caseCreatedAt": "2026-01-15T14:30:00.000Z",
        "usagesInBytes": 52428800
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}