Download a file's browser-displayable version

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 /common/file/{fileId}/display/{fileName}

Downloads the browser-displayable copy of a file (for example HEIC converted to PNG, or audio converted to MP3). No auth. Redirects (307) to that copy when it exists; otherwise redirects to the original and, for convertible types, queues the conversion so the copy exists next time. Streams the bytes when no signed URL is available. Returns 404 when neither copy is available.

Path parameters

fileId string Required

Id of the file
fileName Required

Any file name; ignored, it only gives the URL a readable name

Responses

200 application/octet-stream

The file bytes, streamed when no signed URL is available. Not wrapped in the JSON envelope.
307

Usual answer: redirect (Location header) to a short-lived signed storage URL of the displayable copy, or of the original when the copy is missing.

GET /common/file/{fileId}/display/{fileName}

curl \
 --request GET 'http://api.example.com/common/file/{fileId}/display/{fileName}'