Errors

Conventional HTTP status codes: 2xx for success, 4xx for problems with the request, and 5xx for problems on our side. Failed platform endpoints return a JSON envelope with success: false and a human-readable message.

Status codes

200 · 201 · 202

Success. Creates usually return 201; asynchronous work such as code-system uploads and bulk operations may return 202.

400

Invalid request: malformed body, missing required fields, or values that fail validation.

401

Missing or expired bearer token.

403

Forbidden: plan limits, ownership rules, or modifying sandbox or built-in resources.

404

Resource not found.

409

Conflict, such as uploading a code system whose name and version already exist without replace.

422

Semantically invalid, such as FHIR that fails profile validation.

500

Server error. It is safe to retry idempotent reads.

404 Not FoundError envelope

{
  "success": false,
  "message": "FHIR provider not found"
}