Sift

Common errors

Error bodies are JSON with at least error (human-readable string) and responseTimeMs. Example:

{
  "error": "Missing workspace API key. Send Authorization: Bearer <token> or X-Api-Key",
  "responseTimeMs": 0
}
  • 401: missing, invalid, or revoked workspace API key
  • 400: missing text, malformed JSON POST body (when Content-Type is JSON), or on v2 only: whitespace-only input after trim (Text is empty)
  • 403: this endpoint version is not enabled on the current plan
  • 413: text over 50,000 characters
  • 429: request rate exceeded (retryAfterMs) or monthly quota exceeded (usedBillableUnits and quotaBillableUnits)
  • 405: HTTP method other than GET, POST, or OPTIONS
  • 304: not an error; conditional GET/POST with If-None-Match matching current ETag (only when nocache=true is not set)
  • 502: not used by these endpoints; v2 returns 200 and falls back to the same wordlist engine as v1 if translation fails (see meta.fallback and meta.translationError in the JSON).