integrations

Import device media records (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-media
Access token

Desktop plumbing: registers the device on the caller's case and stores a record for each media file, linking its original and thumbnail already uploaded to S3. Returns how many records 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
  • files array[object] Required
    Hide files attributes Show files attributes object
    • id number Required
    • fileName string Required
    • createdAt string
    • type number
    • duration number
    • uniformType string
    • trashedState number
    • directory string
    • album object
      Hide album attributes Show album attributes object
      • id number Required
      • name string Required
    • originalFileProviderName string
    • thumbnailFileProviderName string
    • metadata 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/case/import-media 
curl \
 --request POST 'http://api.example.com/extraction/case/import-media' \
 --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": {}
  },
  "files": [
    {
      "id": 42.0,
      "fileName": "string",
      "createdAt": "string",
      "type": 42.0,
      "duration": 42.0,
      "uniformType": "string",
      "trashedState": 42.0,
      "directory": "string",
      "album": {
        "id": 42.0,
        "name": "string"
      },
      "originalFileProviderName": "string",
      "thumbnailFileProviderName": "string",
      "metadata": {}
    }
  ]
}'
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": {}
  },
  "files": [
    {
      "id": 42.0,
      "fileName": "string",
      "createdAt": "string",
      "type": 42.0,
      "duration": 42.0,
      "uniformType": "string",
      "trashedState": 42.0,
      "directory": "string",
      "album": {
        "id": 42.0,
        "name": "string"
      },
      "originalFileProviderName": "string",
      "thumbnailFileProviderName": "string",
      "metadata": {}
    }
  ]
}
Response examples (200) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}