Skip to main content
Upload competitive intelligence documents, assets, and battlecards to your library.
POST https://app.usehindsight.com/api/v1/documents/library
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Request fields (multipart/form-data):
  file_name: string (required)
  file_url: string (uri) — URL to fetch file from
  file: binary — binary file content (alternative to file_url)
  content_type: string (required) — MIME type, e.g. application/pdf
  type: asset | intel (required)
  competitor_id: string — Hindsight competitor ID
  competitor_name: string — resolved to competitor_id automatically
  source: drive | notion | confluence | onedrive | sharepoint | vanta | url | zapier | api

200 Response:
{
  "document": {
    "id": "doc_abc123",
    "file_name": "Competitor X Pricing Guide.pdf",
    "status": "processing | ready | failed",
    "type": "asset | intel",
    "url": "https://app.usehindsight.com/deals/deal_123/documents/viewer/doc_abc123",
    "created_at": "2026-02-10T12:00:00Z"
  },
  "run_id": "run_xyz789"
}

Rate limits: 10 req/min (Essentials), 60 req/min (Growth), 300 req/min (Enterprise)
           10,000/mo (Essentials), 30,000/mo (Growth), 100,000/mo (Enterprise)

Document Types

TypeDescription
assetSales enablement content like battlecards, one-pagers, guides
intelCompetitive intelligence gathered from external sources

Source Options

The source field determines the icon displayed in the Hindsight UI:
SourceDescription
driveGoogle Drive
notionNotion
confluenceConfluence
onedriveOneDrive
sharepointSharePoint
vantaVanta
urlWeb URL
zapierZapier automation
apiAPI upload
curl -X POST https://app.usehindsight.com/api/v1/documents/library \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file_name=Competitor X Pricing Guide.pdf" \
  -F "file_url=https://example.com/document.pdf" \
  -F "content_type=application/pdf" \
  -F "type=asset" \
  -F "competitor_name=Competitor X" \
  -F "source=drive"