API Reference

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

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: 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.

List Agents

Introduction

Agents

Chat

Calls

Sessions

Phone Numbers

Tools

Knowledge

Campaigns

Webhooks

BYOK Keys

Base URL

Authentication

Response Format

HTTP Status Codes

Rate Limits

Interactive Playground

​Base URL

​Authentication

​Response Format

​HTTP Status Codes

​Rate Limits

​Interactive Playground

Base URL

Authentication

Response Format

HTTP Status Codes

Rate Limits

Interactive Playground