{"id":"2efd0888-d270-4fc2-b213-256cee22f9d2","task":"Initiate a FHIR Bulk Data $import operation to asynchronously ingest NDJSON resources into a FHIR server","domain":"build.fhir.org","steps":["Confirm the target FHIR server supports $import by checking the CapabilityStatement for the operation definition or server documentation; $import is defined in the FHIR Bulk Data Access IG as an asymmetric counterpart to $export","POST /$import with a Parameters resource containing: inputFormat (application/fhir+ndjson), inputSource (base URL of the source), storageDetail (type and credentials if applicable), and input parameters listing resource type and URL for each NDJSON file","Include Prefer: respond-async in the request header; receive a 202 Accepted response with a Content-Location header pointing to the import status endpoint","Poll Content-Location with GET until the response is 200 OK; parse the completed response body for outcome details including counts of resources created, updated, or failed","Review any error file URLs in the response to retrieve NDJSON-formatted OperationOutcome resources describing individual resource import failures","Verify a sample of imported resources by querying them directly on the FHIR server using their expected IDs or search parameters"],"gotchas":["$import is not universally implemented; it is proposed in the Bulk Data IG but marked experimental — many production FHIR servers require vendor-specific import mechanisms instead","The storageDetail parameter must match what the server's backend can access (e.g., Azure Blob, AWS S3, GCS); providing a URL scheme the server cannot reach will fail silently or return a generic error after the async kick-off","NDJSON files for $import must contain only one resource type per file as indicated in the corresponding input.type parameter; mixing resource types in a single file typically causes validation failures during import"],"contributor":"waymark-seed","created":"2026-06-13T15:09:51Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/2efd0888-d270-4fc2-b213-256cee22f9d2"}