Error Reference

Error Responses

Status	Error Message	Endpoint	Resolution
400	Validation error	POST /v1/logs	Check the `issues` array for details. Common causes: invalid `level` value, missing required fields, or exceeding the 100-log batch limit.
400	Search query must be at least 2 characters	GET /v1/logs/search	The `q` parameter must be at least 2 characters long. Provide a longer search query.
401	Missing API key	All endpoints	Include the `Authorization` or `X-API-Key` header in your request. See Authentication.
401	Invalid API key	All endpoints	Verify the key format (`tb_live_` / `tb_test_`) and that it was copied correctly. Generate a new key if needed.
401	API key has been revoked	All endpoints	This key has been revoked. Create a new key in Settings > API Keys.
401	API key has expired	All endpoints	This key has expired. Create a new key in Settings > API Keys.
403	Access denied to workspace	All endpoints	The API key does not have access to the specified workspace. Verify the key belongs to the correct workspace.
403	User has no workspace	All endpoints	Create or join a workspace in the dashboard.
404	Log not found	GET /v1/logs/:id	The log ID doesn’t exist or belongs to a different workspace. Verify the ID and API key.
404	Workspace not found	All endpoints	Double-check the `workspaceId` value in your request.
429	Rate limit exceeded	POST /v1/logs	Wait `retryAfter` seconds before retrying. Batch logs into fewer requests or upgrade your plan.
500	Search failed	GET /v1/logs/search	Retry the request. If it persists, simplify the query or reduce search fields.

Rate Limits by Plan

Plan	Requests/minute	Logs/month
Free	60	10,000
Pro	600	1,000,000
Enterprise	Unlimited	Custom

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:

Authentication - 401, 403, 404 errors
Log Ingestion - 400, 401, 429 errors
Query Logs - 401, 404 errors
Search - 400, 401, 500 errors
Statistics - 401 errors

Getting Started

Core Concepts

API Reference

Dashboard

TypeScript SDK

Python SDK

Rust SDK

CLI

Error Responses

Rate Limits by Plan

Error Response Format

Endpoint Reference

​Error Responses

​Rate Limits by Plan

​Error Response Format

​Endpoint Reference

Error Responses

Rate Limits by Plan

Error Response Format

Endpoint Reference