API v1.0 (BETA)
Coming Soon
API Reference
The Agent47 API provides a RESTful interface for interacting with your AI employees.Public API Access Launching Q4 2025.
Authentication
All API requests must be authenticated using a Bearer token. You can generate your API keys in the Developer Settings section of your dashboard.
bash
curl -X GET "https://api.agent47.ai/v1/personnel" \
-H "Authorization: Bearer YOUR_API_KEY"Caution
Never expose your API keys in client-side code (browsers, mobile apps). Always use a backend proxy to protect your credentials.
Personnel Chat API
Send tasks or messages to specific AI employees. This endpoint supports streaming responses for real-time interactions.
Endpoint
POST/v1/chat/message
Parameters
- personnel_idstring
Example: "aria", "eric", "clara"
- messagestring
The task or question for the employee.
- streamboolean
Whether to use Server-Sent Events (SSE).
Request Example
{
"personnel_id": "aria",
"message": "Analyze our twitter engagement for Q3",
"options": {
"include_charts": true,
"tone": "analytical"
},
"stream": false
}Rate Limits
To ensure system stability, we enforce rate limits on a per-API-key basis.
| Tier | Request Limit | Burst Allowance |
|---|---|---|
| Standard | 60 req/min | 10 requests |
| Enterprise | 1,200 req/min | 100 requests |
Error Codes
400
Bad Request
The request was missing required parameters.
401
Unauthorized
Invalid or expired API key.
429
Too Many Requests
Daily or per-minute rate limit reached.
500
Internal Server Error
A specialist encountered a temporary cognitive fault.