For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Get API Key
GuidesAPI Reference
GuidesAPI Reference
  • Overview
    • API Reference
  • Endpoint Reference
    • Organizations
    • Projects
    • Documents
    • Agent
    • Check
  • API Explorer
      • GETGet a presigned download URL for a document
      • GETGet a document by ID
      • POSTTrigger processing for uploaded documents
      • GETList documents
      • POSTReserve a document upload slot
      • DELDelete documents by ID
Get API Key
LogoLogo
API ExplorerDocuments

Get a presigned download URL for a document

GET
/api/v2/documents/:id/download
GET
/api/v2/documents/:id/download
$curl https://api.pyramid-ai.com/api/v2/documents/id/download \
> -H "Authorization: Bearer <token>"
1{
2 "request_id": "string",
3 "success": null,
4 "data": {
5 "document_id": "9d11d31d-17ce-4b9f-8c13-63d7058f5fd3",
6 "file_name": "Safety-Management-Plan-2026.pdf",
7 "content_type": "application/pdf",
8 "size_bytes": 2048576,
9 "download_url": "https://storage.supabase.co/object/sign/uploads/orgs/...?token=...",
10 "expires_at": "2026-05-22T10:10:00Z"
11 },
12 "pagination": {
13 "total": 127,
14 "offset": 0,
15 "limit": 50
16 }
17}

Returns a short-lived presigned URL (10-minute expiry) for downloading the original source file. Use this to trace AI-generated citations back to the source document — critical for compliance audit trails.

Was this page helpful?
Previous

Get a document by ID

Next
Built with

Authentication

AuthorizationBearer

Pyramid API key (prefix with “Bearer ”)

Path parameters

idstringRequiredformat: "uuid"

Response

Presigned download URL
request_idstringformat: "uuid"

Server-generated per-request UUID. Also sent as X-Request-Id response header. Include in support tickets.

successany
dataobject
paginationobject

Present only on list endpoints. Top-level (not nested inside data).

Errors

401
Unauthorized Error
404
Not Found Error