Built for Developers
Fast, reliable, and easy to integrate with your existing stack
Secure Authentication
Bearer token and API key authentication with automatic key rotation
Rate Limiting
1,000 requests/min (Starter), 10,000/min (Pro), unlimited (Enterprise)
Global CDN
Low latency worldwide with 25+ edge locations
Real-time Webhooks
Instant event notifications for workflow completion and errors
Data Streaming
Server-sent events for real-time agent execution results
99.99% Uptime SLA
Enterprise-grade reliability with automatic failover
REST API Endpoints
Full REST API with JSON request and response bodies
/api/v1/agents/executeExecute an AI agent task with specified parameters and get real-time results
/api/v1/agentsList all available AI agents with their capabilities and current status
/api/v1/workflows/createCreate a new automated workflow connecting multiple agents
/api/v1/analytics/metricsRetrieve analytics metrics and usage statistics for your account
/api/v1/webhooks/subscribeSubscribe to real-time webhook events for workflow completion, errors, and system updates
/api/v1/statusCheck API health status and version information (no authentication required)
Official SDKs
Idiomatic client libraries for popular programming languages
Node.js
Install:
npm install @hermescloud/nodeExample:
const HermesCloud = require('@hermescloud/node');
const client = new HermesCloud('sk_live_...');
const result = await client.agents.execute({
agent: 'MILLI',
task: 'analyze_data',
params: { dataset: 'sales.csv' }
});Python
Install:
pip install hermescloudExample:
from hermescloud import Client
client = Client(api_key='sk_live_...')
result = client.agents.execute(
agent='MILLI',
task='analyze_data',
params={'dataset': 'sales.csv'}
)Go
Install:
go get github.com/hermescloud/go-sdkExample:
import "github.com/hermescloud/go-sdk"
client := hermescloud.NewClient("sk_live_...")
result, err := client.Agents.Execute(hermescloud.ExecuteParams{
Agent: "MILLI",
Task: "analyze_data",
Params: map[string]interface{}{"dataset": "sales.csv"},
})API Rate Limits
Rate limits based on your subscription tier
| Tier | Requests/Min | Burst Rate | Concurrent |
|---|---|---|---|
| Starter | 1,000/min | 100/sec | 10 |
| Professional | 10,000/min | 500/sec | 50 |
| Enterprise | Unlimited | Custom | Unlimited |
HTTP Status Codes
Standard HTTP status codes and error responses
Bad Request - Invalid parameters or malformed JSON
Unauthorized - Invalid or missing API key
Forbidden - API key lacks required permissions
Not Found - Endpoint or resource does not exist
Rate Limit Exceeded - Too many requests
Internal Server Error - Contact support if persists
Service Unavailable - Temporary maintenance or outage