SUsuki
/api/v1/fhir-push

Upload FHIR bundle to pre-signed URL

Changed on

Upload your FHIR bundle JSON directly to the pre-signed URL obtained from GET /api/v1/fhir-push/upload-url. This is Step 2 of the CKG Data Ingestion workflow. The upload URL is a Google Cloud Storage pre-signed URL that expires after 15 minutes. Use HTTP PUT with the required headers to upload your FHIR bundle (max 500 MB). A 200 OK response confirms the upload was accepted. Any 4xx response indicates an issue such as an expired URL, invalid headers, or file size violation.

put/fhir-push/upload

Request

  • Base URL
    https://sdp.suki.ai
  • URL
    https://sdp.suki.ai/fhir-push/upload
  • Auth
    none required

Query parameters

upload_urlstring required
Example:https://storage.googleapis.com/suki-fhir-push/...

The complete pre-signed upload URL returned from GET /api/v1/fhir-push/upload-url. This is a Google Cloud Storage URL, not a Suki API endpoint.

Request body

object required

FHIR Bundle resource containing Patient, Encounter, Practitioner, and other clinical resources.

Example request

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "resource": {
        "resourceType": "Patient",
        "id": "patient-789",
        "name": [
          {
            "family": "Doe",
            "given": [
              "John"
            ]
          }
        ]
      }
    },
    {
      "resource": {
        "resourceType": "Encounter",
        "id": "enc-123",
        "subject": {
          "reference": "Patient/patient-789"
        }
      }
    }
  ]
}

Response

Upload successful. The FHIR bundle has been accepted and will be processed. Continue to Step 3 to poll ingestion status using the transaction_id from Step 1.

Changes