Skip to content

Errors and rate limits

Errors use the same envelope as successful responses:

{
"status": "error",
"error": { "message": "Invalid, revoked or expired API key", "code": "API_KEY_INVALID", "requestId": "…" }
}
Status Meaning
400 The request does not match the endpoint’s schema.
401 The key is missing, unknown, revoked or expired (API_KEY_INVALID).
403 Your role does not allow this endpoint, or the key’s owner is not a Waalaxy admin during the beta (API_KEY_ADMIN_ONLY).
404 The resource does not exist in your workspace.
429 Too many requests (API_KEY_RATE_LIMITED).

Every response carries an X-Request-Id header, also returned as error.requestId. Send it to us when you report a problem. You can also set your own X-Request-Id on the request.

You can make 60 requests per minute across all your keys. Past that, the API answers 429 with a Retry-After header giving the number of seconds to wait.