Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS HealthLake Datastore API

Operations for creating, describing, listing, and deleting FHIR R4 data stores

AWS HealthLake Datastore API is one of 8 APIs that AWS HealthLake publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Datastore. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 4 operations across 4 paths, and defines 8 schemas. It is described by OpenAPI 3.0.3, at version 2017-07-01.

Requests are made against a single base URL, https://healthlake.{region}.amazonaws.com.

4 operations 4 paths 8 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2017-07-01
Base URL
https://healthlake.us-east-1.amazonaws.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

AWS HealthLake Datastore API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (aws_v4). By default, every request must be authenticated.

  • aws_v4 — AWS Signature Version 4. Sign requests with your AWS access key and secret key. See: https://docs.aws.amazon.com/general/latest/gr/signingawsapirequests.html

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

Datastore 4

Operations for creating, describing, listing, and deleting FHIR R4 data stores

POST
/#X-Amz-Target=HealthLake.CreateFHIRDatastore
CreateFHIRDatastore
createFHIRDatastore 1 param body → 200400500
POST
/#X-Amz-Target=HealthLake.DeleteFHIRDatastore
DeleteFHIRDatastore
deleteFHIRDatastore 1 param body → 200400500
POST
/#X-Amz-Target=HealthLake.DescribeFHIRDatastore
DescribeFHIRDatastore
describeFHIRDatastore 1 param body → 200400500
POST
/#X-Amz-Target=HealthLake.ListFHIRDatastores
ListFHIRDatastores
listFHIRDatastores 1 param body → 200400500

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are CreateFHIRDatastoreRequest (7 properties), CreateFHIRDatastoreResponse (4 properties), DeleteFHIRDatastoreResponse (4 properties), ListFHIRDatastoresRequest (3 properties). Each schema is shown below with its type and property counts.

ListFHIRDatastoresResponse
object
2 properties 1 required
ListFHIRDatastoresRequest
object
3 properties
DeleteFHIRDatastoreRequest
object
1 property 1 required
DescribeFHIRDatastoreResponse
object
1 property 1 required
DeleteFHIRDatastoreResponse
object
4 properties 4 required
CreateFHIRDatastoreRequest
object
7 properties 1 required
CreateFHIRDatastoreResponse
object
4 properties 4 required
DescribeFHIRDatastoreRequest
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aws-healthlake-datastore-api-openapi.yml Raw ↑

Other APIs AWS HealthLake publishes across the network.

AWS HealthLake FHIR Import API
AWS HealthLake FHIR Export API
AWS HealthLake FHIR R4 Server API
AWS HealthLake Resource Tagging API
AWS HealthLake Export API
AWS HealthLake Import API
AWS HealthLake Tags API