integrations

Import device notes (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 /extraction/case/import-notes
Access token

Desktop plumbing: registers the device on the caller's case and stores its notes, linking any attachments already uploaded to S3. Returns how many notes were imported.

application/json

Body Required

  • deviceId string Required
  • deviceType string Required

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

  • deviceMetadata object
  • systemId string Required
  • appVersion string Required
  • osDetails object
    Hide osDetails attributes Show osDetails attributes object
    • arch string
    • platform string
    • version string
    • osType string
    • machine string
    • totalMemory number
    • cpus object Required
    • extraInformation object Required
  • notes array[object] Required
    Hide notes attributes Show notes attributes object
    • id number Required
    • title string Required
    • summary string
    • createdAt string
    • modifiedAt string
    • htmlContent string
    • metadata object
    • attachments array[string]

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/case/import-notes 
curl \
 --request POST 'http://api.example.com/extraction/case/import-notes' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "deviceId": "string",
  "deviceType": "unknown",
  "deviceMetadata": {},
  "systemId": "string",
  "appVersion": "string",
  "osDetails": {
    "arch": "string",
    "platform": "string",
    "version": "string",
    "osType": "string",
    "machine": "string",
    "totalMemory": 42.0,
    "cpus": {},
    "extraInformation": {}
  },
  "notes": [
    {
      "id": 42.0,
      "title": "string",
      "summary": "string",
      "createdAt": "string",
      "modifiedAt": "string",
      "htmlContent": "string",
      "metadata": {},
      "attachments": [
        "string"
      ]
    }
  ]
}'
Request examples 
{
  "deviceId": "string",
  "deviceType": "unknown",
  "deviceMetadata": {},
  "systemId": "string",
  "appVersion": "string",
  "osDetails": {
    "arch": "string",
    "platform": "string",
    "version": "string",
    "osType": "string",
    "machine": "string",
    "totalMemory": 42.0,
    "cpus": {},
    "extraInformation": {}
  },
  "notes": [
    {
      "id": 42.0,
      "title": "string",
      "summary": "string",
      "createdAt": "string",
      "modifiedAt": "string",
      "htmlContent": "string",
      "metadata": {},
      "attachments": [
        "string"
      ]
    }
  ]
}
Response examples (200) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}