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

# POST /annotationStore

`POST /annotationStore`

Amazon Web Services HealthOmics variant stores and annotation stores are no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see [Amazon Web Services HealthOmics variant store and annotation store availability change](https://docs.aws.amazon.com/omics/latest/dev/variant-store-availability-change.html).

Creates an annotation store.

## Request body

- object
  - `reference` object — A genome reference.
    - `referenceArn` string — The reference's ARN.
  - `name` string — A name for the store.
  - `description` string — A description for the store.
  - `tags` object — Tags for the store.
  - `versionName` string — The name given to an annotation store version to distinguish it from other versions.
  - `sseConfig` object — Server-side encryption (SSE) settings for a store.
    - `type` 'KMS' — The encryption type.
    - `keyArn` string — An encryption key ARN.
  - `storeFormat` 'GFF' | 'TSV' | 'VCF', required — The annotation file format of the store.
  - `storeOptions` object — Settings for a store.
    - `tsvStoreOptions` object — File settings for a TSV store.
      - `annotationType` 'GENERIC' | 'CHR_POS' | 'CHR_POS_REF_ALT' | 'CHR_START_END_ONE_BASE' | 'CHR_START_END_REF_ALT_ONE_BASE' | 'CHR_START_END_ZERO_BASE' | 'CHR_START_END_REF_ALT_ZERO_BASE' — The store's annotation type.
      - `formatToHeader` object — The store's header key to column name mapping.
      - `schema` SchemaItem[] — The store's schema.

## Response `200`

Success

- CreateAnnotationStoreResponse
  - `id` string, required — The store's ID.
  - `reference` object — The store's genome reference. Required for all stores except TSV format with generic annotations.
    - `referenceArn` string — The reference's ARN.
  - `storeFormat` 'GFF' | 'TSV' | 'VCF' — The annotation file format of the store.
  - `storeOptions` object — The store's file parsing options.
    - `tsvStoreOptions` object — File settings for a TSV store.
      - `annotationType` 'GENERIC' | 'CHR_POS' | 'CHR_POS_REF_ALT' | 'CHR_START_END_ONE_BASE' | 'CHR_START_END_REF_ALT_ONE_BASE' | 'CHR_START_END_ZERO_BASE' | 'CHR_START_END_REF_ALT_ZERO_BASE' — The store's annotation type.
      - `formatToHeader` object — The store's header key to column name mapping.
      - `schema` SchemaItem[] — The store's schema.
  - `status` 'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'FAILED', required — The store's status.
  - `name` string, required — The store's name.
  - `versionName` string, required — The name given to an annotation store version to distinguish it from other versions.
  - `creationTime` string, date-time, required — When the store was created.

## Other responses

- `480` — InternalServerException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ConflictException
- `485` — ResourceNotFoundException
- `486` — AccessDeniedException

---

[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)