CORE CONCEPTS

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.

413request_too_large

Request body exceeds the configured byte limit.

422schema_error

Spatial input does not satisfy the expected schema.

503runtime_error

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