Upload app logs from S3 (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/app-logs/v2

Access token

Desktop plumbing: same as app-logs, but the log file is one the app already uploaded to S3 (fileProviderId). Returns the Slack message ts as threadTs.

application/json

Body Required

systemId string Required
deviceId string Required
deviceType string Required

Values are unknown, android, ios, facebook_dump, instagram_dump, threads_dump, or email.
date string Required

ISO date string
appVersion string

App version
message string

Message
osDetails object
deviceMetadata object
threadTs string
replyBroadcast boolean
backupMetadata object
errorMetadata object
backupPath string
fileProviderId string Required

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
  
  threadTs string Required
- statusCode number Required
- timestamp string(date-time) Required

POST /extraction/device/app-logs/v2

curl \
 --request POST 'http://api.example.com/extraction/device/app-logs/v2' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "systemId": "string",
  "deviceId": "string",
  "deviceType": "unknown",
  "date": "string",
  "appVersion": "string",
  "message": "string",
  "osDetails": {},
  "deviceMetadata": {},
  "threadTs": "string",
  "replyBroadcast": true,
  "backupMetadata": {},
  "errorMetadata": {},
  "backupPath": "string",
  "fileProviderId": "string"
}'

Request examples

{
  "systemId": "string",
  "deviceId": "string",
  "deviceType": "unknown",
  "date": "string",
  "appVersion": "string",
  "message": "string",
  "osDetails": {},
  "deviceMetadata": {},
  "threadTs": "string",
  "replyBroadcast": true,
  "backupMetadata": {},
  "errorMetadata": {},
  "backupPath": "string",
  "fileProviderId": "string"
}

Response examples (200)

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