Skip to main content

​
Base URL

https://api.thinnest.ai

​
Authentication

All API endpoints require a Bearer token in the Authorization header: 
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.thinnest.ai/v2/agents
See 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

CodeDescription
200Success
201Created
400Bad Request — invalid parameters
401Unauthorized — missing or invalid token
403Forbidden — insufficient permissions
404Not Found — resource doesn’t exist
429Too Many Requests — rate limit exceeded
500Internal Server Error

​
Rate Limits

EndpointLimit
Chat endpoints60 requests/minute
API endpoints120 requests/minute
Knowledge upload10 uploads/hour
Rate limit headers are included in every response: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1709654400

​
Interactive 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.