Reference

Errors & Codes

RenderNest uses standard HTTP status codes combined with machine-readable error codes.

Standard Error Schema

{
  "success": false,
  "request_id": "req_1725432100_9f8e7d",
  "error": {
    "code": "URL_BLOCKED",
    "message": "The target address resolves to a restricted or private destination.",
    "details": {}
  }
}

Error Code	HTTP Status	Description
INVALID_API_KEY	401	API key is missing, malformed, deactivated, or revoked.
INVALID_URL	400	URL string is empty, unparseable, or uses an unsupported protocol.
URL_BLOCKED	403	Target host resolves to private, loopback, or cloud metadata network.
RATE_LIMITED	429	Workspace has exceeded its requests-per-minute ceiling.
QUOTA_EXCEEDED	402	Insufficient credit balance in workspace to pay for operation.
TIMEOUT	504	Target website did not finish loading within the allowed timeout window.
RENDER_FAILED	502	Chromium headless engine encountered a crash or navigation failure.
EXTRACTION_FAILED	502	Parser or structured extractor was unable to decode page content.
ANALYSIS_FAILED	502	Analysis heuristics could not parse document structure.
INVALID_REQUEST	422	Payload failed JSON schema validation rules.
NOT_FOUND	404	Requested job or resource could not be found.
INTERNAL_ERROR	500	An unexpected internal error occurred. Traced via request_id.