Errors & reliability

Phenoml uses conventional HTTP status codes, and the distinction between terminal and retryable errors matters for robust integrations.

Status codes

• 400 means invalid request; correct the input before retrying.
• 401 means missing or expired auth.
• 429 means rate limited; honor retry headers.
• 5xx usually means a transient server-side failure.

FHIR proxy

FHIR provider calls pass upstream status codes and bodies through unchanged, so handle non-JSON upstream errors gracefully.

Async work

Custom code-system uploads return immediately and finish in the background. Poll until the status is ready or failed.

See Errors.