Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.myhero.so/llms.txt

Use this file to discover all available pages before exploring further.

Base URL

https://app.myhero.so
All endpoints are scoped under /api. Example: https://app.myhero.so/api/document/{documentId}.

Authentication

Every request requires a bearer token:
Authorization: Bearer hero_ak_<your-key>
See Authentication for how to generate one.

Pagination

List endpoints accept limit (default 50, max 200) and cursor. Responses include a nextCursor field when more results are available.
GET /api/document/all/{projectId}?limit=20&cursor=abc123

Errors

All errors return a uniform shape:
{
  "error": "ValidationError",
  "message": "Request failed schema validation",
  "details": [...]
}
See Errors for the full status code list.

Versioning

The HERO API does not use a version prefix today. Breaking changes are announced in the changelog and gated behind opt-in headers when introduced.

Your first request

curl https://app.myhero.so/api/workspace \
  -H "Authorization: Bearer $HERO_TOKEN"