---
title: "POST /referencestore"
method: POST
path: "/referencestore"
---

# POST /referencestore

`POST /referencestore`

Creates a reference store and returns metadata in JSON format. Reference stores are used to store reference genomes in FASTA format. A reference store is created when the first reference genome is imported. To import additional reference genomes from an Amazon S3 bucket, use the `StartReferenceImportJob` API operation.

For more information, see [Creating a HealthOmics reference store](https://docs.aws.amazon.com/omics/latest/dev/create-reference-store.html) in the _Amazon Web Services HealthOmics User Guide_.

## Request body

- object
  - `name` string, required — A name for the store.
  - `description` string — A description for the store.
  - `sseConfig` object — Server-side encryption (SSE) settings for a store.
    - `type` 'KMS' — The encryption type.
    - `keyArn` string — An encryption key ARN.
  - `tags` object — Tags for the store.
  - `clientToken` string — To ensure that requests don't run multiple times, specify a unique token for each request.

## Response `200`

Success

- CreateReferenceStoreResponse
  - `id` string, required — The store's ID.
  - `arn` string, required — The store's ARN.
  - `name` string — The store's name.
  - `description` string — The store's description.
  - `sseConfig` object — The store's SSE settings.
    - `type` 'KMS', required — The encryption type.
    - `keyArn` string — An encryption key ARN.
  - `creationTime` string, date-time, required — When the store was created.

## Other responses

- `480` — InternalServerException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — AccessDeniedException
- `485` — RequestTimeoutException

---

[API](https://skmtc.net/aws/apis/omics.md) · [All operations](https://skmtc.net/aws/apis/omics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/omics/versions/e9df1bcc0813/schema)