Error Codes

Zywrap uses standard HTTP status codes to indicate the success or failure of your API requests.

In general: codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted). Codes in the 5xx range indicate an error with Zywrap's servers.

Error Response Format

All error responses will return a JSON object with an error key containing a machine-readable code and a human-readable message.

json
{
    "error": {
        "code": "invalid_api_key",
        "message": "The API key provided is invalid or has been revoked."
    }
}

Common Error Codes

StatusCodeDescription
400bad_requestThe request was unacceptable, often due to missing a required parameter.
401unauthorizedNo valid API key provided.
402payment_requiredYour account has insufficient credits or your subscription has expired.
403forbiddenThe API key doesn't have permissions to perform the request.
404not_foundThe requested resource (e.g., wrapper code) could not be found.
429rate_limit_exceededToo many requests hit the API too quickly. Please implement backoff.
500internal_server_errorSomething went wrong on Zywrap's end. (These are rare).
Ready to ship?

Start building with Zywrap today.

Stop wrestling with prompts. Integrate powerful, structured AI into your applications in minutes.