Health and tenants
Use health and readiness checks, then create, inspect, update, or remove tenant resources as authorized.
Hermes Hub API
How do I call Hermes Hub through its external API?
Call Hermes Hub through its external API by using the Hub URL supplied by the operator, authenticating management requests with a bearer token, and sending requests to the documented /v1 endpoint groups. The public contract covers tenant lifecycle, agents, runs, files, skills, cron, shares, credentials, and policy without exposing private runtime internals.
Start with the API surface
Keep client integration aligned with the documented endpoint purpose and tenant scope.
Agent lifecycle and runs
Manage tenant agent state, start runs, inspect events, and handle terminal operations.
Files and controls
Use tenant file, share, skill, cron, credential, and policy surfaces according to their access rules.
API documentation
External REST contract
Review authentication, response conventions, endpoint groups, and non-client runtime boundaries.
Learn moreTenant environment
Understand the paths and environment keys visible inside a tenant runtime.
Learn moreA2A edge
See how controlled agent cards, credentials, peers, and routed messages fit the Hub boundary.
Learn moreHermes Hub API FAQ
What authentication does the management API use?
Management endpoints require an Authorization bearer token. Webhooks use their relevant upstream verification scheme.
Are all endpoints public client APIs?
No. Tenant-runtime callback paths are reserved for runtime callbacks and Hub-managed proxying unless a compatible client has the required credential.
How should clients handle long-lived event streams?
Clients should handle reconnects and terminal run states because event streams can be long-lived responses.
Plan a Hermes Hub integration
Discuss tenant-scoped API integration, lifecycle operations, files, skills, cron, shares, and policy.
Architecture conversation
Tell us what your team needs to control
Share your deployment boundary, number of agents, work surfaces, and governance requirements. We will reply by email to arrange a focused technical discussion.
Email the Bewize teamThis opens your email application. Read our Privacy Policy.