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.

The HERO REST API authenticates with API keys issued from your account settings. Pass the key on every request as: 
Authorization: Bearer hero_ak_<...>

​
Generating an API key

  1. Sign in at app.myhero.so.
  2. Open Settings → Account → API Keys and click Generate new API key.
  3. Choose a name, workspace scope (all of your workspaces, or specific ones), and an expiry. Copy the key — it’s shown once.
  4. Use it in any Authorization: Bearer <key> header.
API keys inherit your user permissions within the workspaces they’re scoped to. Revoking a key from the same settings page invalidates it immediately.

​
MCP authentication is separate

If you’re connecting an AI tool via MCP, don’t use a REST API key. MCP uses its own personal access tokens (prefix hero_at_*) issued from Settings → MCP Tokens. See the MCP overview for the MCP-specific flow. If you send an MCP token to the REST API, the server returns a 401 with error: "WrongTokenKind" to make the mismatch obvious.