Report device storage usage (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"
  }
}

POST /extraction/device/storage-updates

Access token

Desktop plumbing: saves the storage figures the app calculated for a device, keyed by its device id. If the device already has a storage log, the previous figures are kept in its history and the user-reported figures are cleared.

application/json

Body Required

deviceId string Required
osVersion string
phoneHardwareVersion string
phoneOtherInfo object
calculatedTotalSpaceUsed number
calculatedTotalDiskSpace number
otherStorageMetadata object

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 /extraction/device/storage-updates

curl \
 --request POST 'http://api.example.com/extraction/device/storage-updates' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "deviceId": "string",
  "osVersion": "string",
  "phoneHardwareVersion": "string",
  "phoneOtherInfo": {},
  "calculatedTotalSpaceUsed": 42.0,
  "calculatedTotalDiskSpace": 42.0,
  "otherStorageMetadata": {}
}'

Request examples

{
  "deviceId": "string",
  "osVersion": "string",
  "phoneHardwareVersion": "string",
  "phoneOtherInfo": {},
  "calculatedTotalSpaceUsed": 42.0,
  "calculatedTotalDiskSpace": 42.0,
  "otherStorageMetadata": {}
}

Response examples (200)

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