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
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.
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"