uploads
mcp
downloads

Get a pre-signed URL to download an exported document without proxying through the agent.

Returns a short-lived (15-minute) GET URL plus a ready-to-run curl_example. An agent with shell access can run the curl_example directly to save the exported file to the working directory, so the bytes never pass through its context window; clients without shell execution (or callers who only want the link) can use the signed URL directly. Generates the document in the requested format and returns a time-limited signed download URL. Specify format as 'pdf', 'docx', 'html', 'markdown', or 'txt' (legacy 'doc' also accepted).

post/v1/downloads

Request

  • Base URL: https://api.superdocs.app
  • URL: https://api.superdocs.app/v1/downloads
  • Auth: HTTP bearer

Headers

authorizationstring nullable

Request body

session_idstring required

Session ID whose current document should be exported and packaged for download.

format'docx' | 'pdf' | 'html' | 'markdown' | 'txt' | 'doc'

Export format (docx, pdf, html, markdown, txt).

filenamestring nullable

Optional Content-Disposition filename for the download (without extension). Auto-detected from the document's first heading if not provided.

Response

Successful Response

download_urlstring required
expires_atstring required
expires_in_secondsinteger required
curl_examplestring required
filenamestring required
formatstring required

Changes

No recorded changes to this operation across all 1 revision of this API.