API Reference
Complete REST API reference for the thinnestAI platform.
Base URL
https://api.thinnest.aiAuthentication
All API endpoints require a Bearer token in the Authorization header:
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.thinnest.ai/v2/agentsSee Authentication for details on obtaining tokens.
Response Format
All responses return JSON:
{
"data": { ... },
"message": "Success",
"status": 200
}Error responses:
{
"detail": "Error description",
"status": 400
}HTTP Status Codes
| Code | Description |
|---|---|
200 | Success |
201 | Created |
400 | Bad Request — invalid parameters |
401 | Unauthorized — missing or invalid token |
403 | Forbidden — insufficient permissions |
404 | Not Found — resource doesn't exist |
429 | Too Many Requests — rate limit exceeded |
500 | Internal Server Error |
Rate Limits
| Endpoint | Limit |
|---|---|
| Chat endpoints | 60 requests/minute |
| API endpoints | 120 requests/minute |
| Knowledge upload | 10 uploads/hour |
Rate limit headers are included in every response:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1709654400Interactive Playground
Each endpoint page includes an interactive playground where you can test API calls directly from the browser. Enter your base URL and Bearer token to get started.