Skip to main content
HERO is a collaborative document platform with built-in AI agents and native Model Context Protocol integration.

​
What you can build

  • Document automation — programmatically create, update, and organise documents.
  • AI workflows — invoke HERO’s specialised agents from your own product.
  • MCP integrations — let any MCP-compatible AI tool work with HERO content.
  • Realtime collaboration — connect to realtime document states and work with others.

​
Get started in 3 steps

Pick the path that matches how you’re integrating.
For calling HERO REST API directly from your own code or provider.
1

Generate an API key

Sign in at HERO, open Settings, and click Generate new API key.
Copy the hero_ak_* key — it’s shown once.See Authentication for the full walkthrough.
2

Make your first request

Get the default user workspace to confirm auth works:
curl https://app.myhero.so/api/workspace/default \
  -H "Authorization: Bearer hero_ak_<your-key>"
See Working with the API for conventions.
3

Browse the reference

Every public endpoint is documented in the API reference.
An API/MCP access token acts as you — anyone holding it has the same access to your account, workspaces, and documents that you do. Treat it like a password.
  • Never commit a token to git or paste it into chat, screenshots, issue trackers, or logs.
  • Never embed a token in client-side code or anything served to a browser.
  • Never share a token with another person or paste it into untrusted MCP clients.
  • If a token is exposed, revoke it immediately from Account Settings and generate a new one.

​
Need help?

File us an email at hello@myhero.so or join the community Discord.