Skip to main content

​
Error Responses

StatusError MessageEndpointResolution
400Validation errorPOST /v1/logsCheck the issues array for details. Common causes: invalid level value, missing required fields, or exceeding the 100-log batch limit.
400Search query must be at least 2 charactersGET /v1/logs/searchThe q parameter must be at least 2 characters long. Provide a longer search query.
401Missing API keyAll endpointsInclude the Authorization or X-API-Key header in your request. See Authentication.
401Invalid API keyAll endpointsVerify the key format (tb_live_* / tb_test_*) and that it was copied correctly. Generate a new key if needed.
401API key has been revokedAll endpointsThis key has been revoked. Create a new key in Settings > API Keys.
401API key has expiredAll endpointsThis key has expired. Create a new key in Settings > API Keys.
403Access denied to organizationAll endpointsThe API key does not have access to the specified organization. Verify the key belongs to the correct org.
403User has no organizationAll endpointsCreate or join an organization in the dashboard.
404Log not foundGET /v1/logs/:idThe log ID doesn’t exist or belongs to a different organization. Verify the ID and API key.
404Organization not foundAll endpointsDouble-check the organizationId value in your request.
429Rate limit exceededPOST /v1/logsWait retryAfter seconds before retrying. Batch logs into fewer requests or upgrade your plan.
500Search failedGET /v1/logs/searchRetry the request. If it persists, simplify the query or reduce search fields.

​
Rate Limits by Plan

PlanRequests/minuteLogs/month
Free6010,000
Pro6001,000,000
EnterpriseUnlimitedCustom

​
Error Response Format

All errors follow a consistent JSON format: 
{
  "error": "Human-readable error message"
}
Validation errors include additional detail: 
{
  "error": "Validation error",
  "issues": [
    {
      "path": ["logs", 0, "level"],
      "message": "Invalid enum value"
    }
  ]
}
Rate limit errors include a retry hint: 
{
  "error": "Rate limit exceeded",
  "retryAfter": 60
}

​
Endpoint Reference

For full details on each endpoint’s error handling: