---
title: "Add store"
method: POST
path: "/store/add"
---

# Add store

`POST /store/add`

## Request

- Base URL: `http://localhost:21721`
- URL: `http://localhost:21721/store/add`
- Auth: HTTP bearer

Creates the new store in the xpipe vault from raw json data.
This can also perform an optional validation first to make sure that the store can be established.

If an equivalent store already exists, no new one will be added and the existing one's ID will be returned.

For details on the JSON schema of a connection type, take a look at the existing vault data of other connections.

## Request body

- StoreAddRequest
  - `name` string, required: The store name
  - `data` object, required: The raw store store data. Schemas for store types are not documented, but you can find the store data of your existing stores in the xpipe vault.
  - `validate` boolean, required: Whether to perform a store validation before adding it, i.e., probe the store first. If validation is enabled and fails, the store will not be added
  - `category` string: The category uuid to put the store in. If not specified, the default category will be used

## Response `200`

The request was successful. The store was added.

- StoreAddResponse
  - `store` string, required: The store uuid

## Other responses

- `400`: Bad request. Please check error message and your parameters.
- `401`: Authorization failed. Please supply a `Bearer` token via the `Authorization` header.
- `403`: Authorization failed. Please supply a valid `Bearer` token via the `Authorization` header.
- `500`: Internal error.

---

[API](https://skmtc.dev/xpipe/apis/xpipe-api-documentation.md) - [All operations](https://skmtc.dev/xpipe/apis/xpipe-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/xpipe/apis/xpipe-api-documentation/revisions/cc0e84caab21?raw)