---
title: "Create a store"
method: POST
path: "/v0/stores"
tags: ["Stores"]
---

# Create a store

`POST /v0/stores`

Create a store to export data to, under current workspace

## Request body

- CourierCreateStoreRequest
  - `name` string, required — Unique user friendly name for easier identification
  - `type` 'S3' | 'GCS' | 'AZBLOB', required
  - `configs` DomainStoreConfigs, required
    - `bucket` string, required — Name of the bucket to be used for data transfers
    - `region` string, required — Region as defined by cloud provider
    - `path_prefix` string — Path prefix to be used for all transfers.
  - `secrets` object, required — Credentials to be used for transferring data to specified bucket These vary for each cloud provider - - **S3** - `access_key_id`, `secret_access_key` - **AZBLOB** - `account_name`, `tenant_id`, `client_id`, `client_secret` - **GCS** - `project_id`, `service_account_credentials`
  - `labels` object — User defined labels for metadata

## Response `200`

OK

- CourierCreateStoreResponse
  - `id` string — Identifier to be used while transferring data
  - `name` string — Unique user friendly name for easier identification
  - `type` 'S3' | 'GCS' | 'AZBLOB'
  - `configs` DomainStoreConfigs
    - `bucket` string, required — Name of the bucket to be used for data transfers
    - `region` string, required — Region as defined by cloud provider
    - `path_prefix` string — Path prefix to be used for all transfers.
  - `labels` object — User defined labels for metadata
  - `created_at` string — Store creation time
  - `updated_at` string — Store last updated time
  - `created_by` string — Identifier of the user that created store

## Other responses

- `400` — Bad Request
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/revisions/b501e2ca5a9d/schema)