Errors

Common HTTP status codes for tool API calls and how to fix them.

Tool API errors

Status	Cause	Fix
`401`	Missing, invalid, or revoked `X-Api-Key`	Create a new key in the dashboard
`403`	Tool blocked for your plan	Upgrade plan or contact support
`429`	Monthly quota or per-minute rate limit	Check usage in the dashboard or upgrade your plan
`413`	File too large	Reduce upload size per tool limits
`500`	Conversion or processing failed	Retry; verify file format and payload
`503`	Service temporarily unavailable	Retry with backoff

Most errors return JSON:

{
  "message": "Human-readable description"
}

Quota errors may include extra fields:

{
  "message": "Monthly usage limit exceeded for this period",
  "type": "monthly_quota",
  "current": 500,
  "limit": 500
}

Include the request path, status code, and message when contacting support. Do not share full API keys — use the key prefix only (ty_a1b2).

Calling Tools

How to call convertors, documents, and text utilities with your API key.

Tool APIs

Overview of ToolYour tool endpoints by category — all require X-Api-Key.