---
title: "Create Storage"
method: POST
path: "/v1/storage/storages"
tags: ["Storage"]
---

# Create Storage

`POST /v1/storage/storages`

## Request

- The document declares no server URL.
- Auth: OAuth 2
  - Password
  - Token URL: `token` scopes: `storage`

Connects storage to Claid. You can connect your AWS S3 or GCP bucket, or your own web folder.

## Request body

- StorageInPydantic
  - `name` string, required: The name of storage in Claid. Note: it doesn't have to be the same as a global name of a bucket.
  - `type` 'web_folder' | 's3' | 'gcs', required: An enumeration.
  - `parameters` union, required: Global parameters of storage (as opposed to Claid's internal properties, such as `name` and `type`)
    - S3ParametersPydantic
      - `path` string: An optional relative path that is prepended to the image request path when building the image's path.
      - `bucket` string, required: A global Amazon S3 bucket name.
      - `credentials` AWSCredentials, required: Check [AWS security credentials docs](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html) to learn how to get your access keys.
        - `access_key` string, required: Access Key
        - `secret_access_key` string, required: Secret Access Key
    - GCSParametersPydantic
      - `path` string: An optional relative path that is prepended to the image request path when building the image's path.
      - `bucket` string, required: A global GCS bucket name.
      - `credentials` GCPCredentials, required: Check [GCP documentation](https://cloud.google.com/iam/docs/creating-managing-service-account-keys) to learn how to get your access keys.
        - `access_key` string, required: Access Key
        - `secret_access_key` string, required: Secret Access Key
    - WebFolderParametersPydantic
      - `base_url` string, required

## Response `200`

Successful Response

- ResponseStorageOutDetailedPydantic: Wrapper for responses
  - `data` StorageOutDetailedPydantic
    - `id` integer, required
    - `name` string, required
    - `type` 'web_folder' | 's3' | 'gcs', required: An enumeration.
    - `parameters` union, required
      - CloudDetailedBaseStorage
        - `path` string: An optional relative path that is prepended to the image request path when building the image's path.
        - `bucket` string, required
        - `credentials` CredentialsOut, required
          - `access_key` string, required
      - WebFolderParametersPydantic
        - `base_url` string, required
    - `created_at` string, date-time, required

## Other responses

- `401`: Authorization is required.
- `403`: Not enough permissions.
- `422`: Unprocessable Entity.

## Changes

- **2026-11-03** `18c907f76458`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/claid/apis/claid-rest-api/changes/v1/storage/storages/post.md)

---

[API](https://skmtc.dev/claid/apis/claid-rest-api.md) - [All operations](https://skmtc.dev/claid/apis/claid-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/claid/apis/claid-rest-api/revisions/18c907f76458?raw)