The Intelligence API is the project-scoped surface for generating and reading Hivemind's research artifacts: structured intelligence reports and the raw tool outputs they're synthesized from. Used by internal agents and downstream Hivemind products to attach project-specific market context to their workflows.

This is not the public Hivemind API. Public endpoints (/api/v1/chat, /api/v1/projects, /api/knowledge/search) are documented at /api-docs on the main webapp.

Endpoints:

• POST /api/intelligence/reports/generate — enqueue a report generation job
• GET /api/intelligence/jobs/:job_id — poll job status
• GET /api/intelligence/reports/:project_id — list reports for a project (paginated)
• GET /api/intelligence/reports/:project_id/:report_type — fetch latest report of a given type
• GET /api/intelligence/tool-outputs/:project_id/:tool_type — fetch raw research-tool outputs (paginated)

Base URL: https://hivemind.myosin.xyz

Authentication

All requests use a Bearer token in the Authorization header.

curl -H "Authorization: Bearer <key>" ...

Requesting a key: contact a Hivemind administrator. Keys are attributed to a user and scoped to specific projects at issue time.

Missing header returns 401 UNAUTHORIZED:

{
  "status": "error",
  "code": "UNAUTHORIZED",
  "message": "Missing authorization header"
}

The auth layer classifies each request as either a generation call (only POST /reports/generate) or a retrieval call (everything else). Each class has its own per-minute rate limit.

POST /api/intelligence/reports/generate