Errors

Four Echelon APIs return structured errors with a message and type. Treat non-2xx responses as failed requests and preserve request ids for debugging and support.

Error codes

Preserve request ids when reporting API failures.

400invalid_request_error

Malformed JSON or unsupported model id.

401authentication_error

Missing, revoked, or invalid API key.

402payment_required

An active or trialing paid API subscription is required.

413request_too_large

Request body exceeds the configured byte limit.

415unsupported_file_type

SolidWorks native and other unsupported CAD formats. Export STEP and retry.

422schema_error

Spatial input does not satisfy the expected schema.

429rate_limit_error

Per-key rate limit exceeded. Retry after a short delay.

503runtime_error

Hosted runtime is unreachable and no fallback can complete the request.