Features
Built-In Gateway
API Gateway
Every agent gets a unique endpoint. Auth, rate limiting, and logging built in.
Your Agent's Endpoint
POST https://your-agent.hostagentes.com/api/v1/chat
Authorization: Bearer ha_your_api_key
Content-Type: application/json
Integrate with any language, framework, or tool that makes HTTP requests.
Built-In Features
Authentication
Bearer token auth with scoped API keys. Create multiple keys, revoke individually.
Rate Limiting
Per-key and per-agent limits. Protect your agent from abuse and control costs.
Request Logging
Every request logged with full detail. Search by date, key, agent, or content.
Streaming (SSE)
Server-Sent Events for real-time partial responses. No waiting for full completion.
Error Handling
Standard HTTP status codes with descriptive error messages and retry guidance.
Custom Domains
Use your own domain instead of the default hostagentes.com subdomain.
Rate Limits by Plan
60
requests/min (Starter)
300
requests/min (Pro)
Custom
requests/min (Scale)
Quick Integration
JAVASCRIPT
const res = await fetch(url, {
method: 'POST',
headers: {
'Authorization': 'Bearer ha_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'Hello!'
})
});PYTHON
import requests
res = requests.post(url,
headers={
'Authorization': 'Bearer ha_key',
'Content-Type': 'application/json'
},
json={'message': 'Hello!'}
)Frequently Asked Questions
Does every agent get its own API endpoint?
Yes. Each deployed agent receives a unique URL (your-agent.hostagentes.com) with its own API endpoint, authentication keys, rate limits, and request logging.
What authentication method does the API use?
Bearer token authentication. Generate scoped API keys from your dashboard. Each key can be limited to specific agents and configured with custom expiration dates.
Does the API support streaming responses?
Yes. Use the /chat/stream endpoint for Server-Sent Events (SSE). You receive partial responses in real-time as the agent generates them — no waiting for full completion.
What are the rate limits?
Starter: 60 requests/min and 10,000/day. Pro: 300 requests/min and 100,000/day. Scale: Custom limits with unlimited daily requests.
Can I use a custom domain for the API?
Yes. Configure a custom domain in your agent settings. SSL certificates are managed automatically. Your API endpoint becomes your-domain.com/api/v1/chat.