---
title: "Create backup storage"
method: POST
path: "/namespaces/{namespace}/backup-storages"
tags: ["Backup Storage"]
---

# Create backup storage

`POST /namespaces/{namespace}/backup-storages`

This API creates a new backup storage.

**Examples**:
  ```
  {
    "metadata": {
      "name": "s3-storage",
      "namespace": "everest",
    },
    "spec": {
      "type": "s3",
      "bucketName": "bucket1",
      "accessKey": "access_key",
      "secretKey": "secret_key",
      "region": "eu-central-1"
    },
  }
  ```

  ```
  {
    "metadata": {
      "name": "azure-storage",
      "namespace": "everest",
    },
    "spec": {
      "type": "azure",
      "bucketName": "container1",
      "accessKey": "storage_account_name",
      "secretKey": "storage_account_key",
    },
  }
  ```

## Path parameters

- `namespace` string, required

## Request body

- CreateBackupStorageParams — Backup storage parameters
  - `name` string, required — A user defined string name of the storage in the DNS name format https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names
  - `description` string
  - `type` 's3' | 'azure', required
  - `bucketName` string, required — The cloud storage bucket/container name
  - `accessKey` string, required
  - `secretKey` string, required
  - `url` string
  - `region` string
  - `allowedNamespaces` string[] — List of namespaces allowed to use this backup storage
  - `verifyTLS` boolean
  - `forcePathStyle` boolean

## Response `200`

Successful operation

- BackupStorage — Backup storage information
  - `type` 's3' | 'azure', required
  - `namespace` string
  - `name` string, required
  - `description` string
  - `bucketName` string, required
  - `url` string
  - `region` string
  - `verifyTLS` boolean
  - `forcePathStyle` boolean
  - `allowedNamespaces` string[] — List of namespaces allowed to use this backup storage

## Other responses

- `400` — Unsuccessful operation
- `500` — Internal server error

## Changes

- **2024-08-27** `80fee12bc715` — 1 info
  - endpoint added
- **2024-04-12** `dec31e5eea8e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/openeverest/apis/openeverest-schema/changes/namespaces/:namespace/backup-storages/post.md)

---

[API](https://skmtc.dev/openeverest/apis/openeverest-schema.md) · [All operations](https://skmtc.dev/openeverest/apis/openeverest-schema/llms.txt) · [OpenAPI document](https://skmtc.dev/openeverest/apis/openeverest-schema/revisions/b308ab35458e?raw)