$load

You can efficiently load data into Aidbox  in ndjson gz format from external web service or bucket. There are two versions of $load - /$load and /[resourceType]/$load.  First can load multiple resource types from one ndjson file, second is more efficient, but loads only for a specific resource type. Both operations accept body with source element, which should be publicly available url. If you want to secure your import use Signed URLs by Amazon S3 or Google Storage. 
There are two versions of this operation - /fhir/$load accepts data in FHIR format,  /$load works with Aidbox format.
Keep in mind that $load does not validate inserted resources for the sake of performance. Pay attention to the structure of data you insert and use the correct URL for your data format, i.e.: use /fhir prefix for FHIR data.
Please consider using Asynchronous validation API to validate data after $load
 Load 100 synthea Patients to Aidbox (see tutorial):
1
POST /fhir/Patient/$load
2
Content-Type: text/yaml
3
​
4
source: 'https://storage.googleapis.com/aidbox-public/synthea/100/Patient.ndjson.gz'
5
​
6
#resp
7
{total: 124}
Copied!
update: true
By default for performance reasons $load does raw upsert into resource table without updating history. If you want to store the previous version of resources in history, you have to set update = true, with this flag Aidbox will update history for updated resources.
1
POST /fhir/Patient/$load
2
Content-Type: text/yaml
3
​
4
source: <new-version-of-data>
5
update: true
Copied!
$load multiple resource types
Or load the whole synthea package:
1
POST /fhir/$load
2
Content-Type: text/yaml
3
​
4
source: 'https://storage.googleapis.com/aidbox-public/synthea/100/all.ndjson.gz'
5
​
6
# resp
7
​
8
{CarePlan: 356, Observation: 20382, MedicationAdministration: 150, .... }
Copied!

$export

$import & /fhir/$import

Last modified 4mo ago

Copy link

Contents

update: true

$load multiple resource types