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

# POST /share

`POST /share`

Creates a cross-account shared resource. The resource owner makes an offer to share the resource with the principal subscriber (an AWS user with a different account than the resource owner).

The following resources support cross-account sharing:

*   HealthOmics variant stores
    
*   HealthOmics annotation stores
    
*   Private workflows

## Request body

- object
  - `resourceArn` string, required — The ARN of the resource to be shared.
  - `principalSubscriber` string, required — The principal subscriber is the account being offered shared access to the resource.
  - `shareName` string — A name that the owner defines for the share.

## Response `200`

Success

- CreateShareResponse
  - `shareId` string — The ID that HealthOmics generates for the share.
  - `status` 'PENDING' | 'ACTIVATING' | 'ACTIVE' | 'DELETING' | 'DELETED' | 'FAILED' — The status of the share.
  - `shareName` string — The name of the share.

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