Errors
Stable error codes in the Taliiq public API v1
Live API testing
Paste a tq_live_… key from Settings → API Keys. Requests are sent through this docs server to /api/v1/… (no browser CORS). The key is kept in sessionStorage only.
All errors use this envelope:
{
"status": "error",
"message": "Human-readable summary",
"error": {
"code": "validation_error",
"details": {}
},
"meta": {
"request_id": "uuid"
}
}Stable codes
| Code | HTTP | Meaning |
|---|---|---|
invalid_api_key | 401 | Missing, invalid, or revoked key |
insufficient_scope | 403 | Key lacks required scope |
not_found | 404 | Resource does not exist |
validation_error | 422 | Invalid request body or query |
resource_in_use | 409 | Delete blocked — resource still linked or active |
idempotency_conflict | 409 | Idempotency key reused with different body |
rate_limited | 429 | Per-key rate limit exceeded |
Include meta.request_id when contacting support.