Reference

REST API reference

Every Platform API operation, generated from the OpenAPI snapshot and grouped by resource.

Last updated 2026-07-27

This reference is generated from the published OpenAPI snapshot so it matches what the Platform API actually exposes. The raw spec lives at /api/platform/openapi.json.

Authenticate every request with a bearer token (hb_sk_* for backends) and call the base endpoint. Costs, scopes, and rate limits are described in Core concepts. Prefer MCP when you are wiring an interactive agent client.

v1.0.0
Version
26
Operations
26
Paths

activity

GET/v1/activity

List Agent Activity

context

GET/v1/context/brief

Get Company Brief

POST/v1/context/corrections

Correct Company Context

GET/v1/context/export

Export Company Brain

POST/v1/context/memories

Remember Company Context

POST/v1/context/resolve

Resolve Open Question

POST/v1/context/search

Search Context

POST/v1/context/sources

Ingest Context Source

POST/v1/context/sources/adoptions

Adopt Existing Context Source

POST/v1/context/sources/uploads

Upload Large Context Source

POST/v1/context/sync

Sync Company Context

decision

POST/v1/decisions

Record Decision

POST/v1/decisions/search

Search Decisions

engineering

GET/v1/engineering/brief

Get Engineering Brief

GET/v1/engineering/incidents

List Engineering Incidents

GET/v1/engineering/incidents/{incidentId}

Get Engineering Incident

linear

POST/v1/linear/issues/title

Update Linear Issue Title

mcp

POST/mcp

HiveBase MCP endpoint

receipt

GET/v1/receipts/{receiptId}

Get Write Receipt

task

POST/v1/tasks

Create Task

GET/v1/tasks/{taskId}

Get Task

POST/v1/tasks/{taskId}/mailbox/read

Read Task Mailbox

POST/v1/tasks/{taskId}/needs-you

Request Human Attention

POST/v1/tasks/{taskId}/posts

Post Task Update

POST/v1/tasks/{taskId}/status

Set Task Status

POST/v1/tasks/search

Search Tasks