Base URL
All API requests are made to the following base URL:
Authentication
Tuteliq supports two methods of authentication. Include one of the following in every request:
- Bearer token in the
Authorization header:
Authorization: Bearer YOUR_API_KEY
- API key header:
All responses are returned as JSON.
A successful response follows this structure:
An error response follows this structure:
{
"error": {
"code": "ERROR_CODE",
"message": "A human-readable description of the error."
}
}
Rate Limits
Rate limits are enforced per API key based on your plan tier:
| Tier | Requests per minute |
|---|
| Free | 60 |
| Basic | 300 |
| Premium | 1,000 |
| Enterprise | 5,000 |
429 Too Many Requests status with the RATE_LIMIT_EXCEEDED error code.
Common Error Codes
| Code | HTTP Status | Description |
|---|
AUTH_INVALID_KEY | 401 | The provided API key is invalid or unrecognized. |
AUTH_EXPIRED_KEY | 401 | The API key has expired. |
RATE_LIMIT_EXCEEDED | 429 | You have exceeded your rate limit. |
VAL_INVALID_INPUT | 400 | The request body or parameters failed validation. |
SVC_INTERNAL_ERROR | 500 | An unexpected internal error occurred. |
Endpoints
Endpoint pages are auto-generated from the OpenAPI specification and appear in the sidebar under this tab. Each page includes request/response schemas, parameter descriptions, and an interactive playground.
| Group | Description |
|---|
| Safety | Content safety analysis — bullying, grooming, unsafe content detection |
| Analysis | In-depth emotional and behavioral analysis |
| Guidance | Age-appropriate guidance and action plan generation |
| Reports | Structured safety and compliance report generation |
| Batch | Bulk processing for high-volume operations |
| Webhooks | Webhook configuration and event management |
| Usage | Credit balance and API usage metrics |
| Compliance | GDPR data subject rights and audit endpoints |
| Health | Service health checks and system status |
