---
title: "Create a backend."
method: POST
path: "/v1/{tenantId}/backends"
tags: ["Backend"]
---

# Create a backend.

`POST /v1/{tenantId}/backends`

## Request body

- BackendRequest
  - `name` string — The backend name specified by user.
  - `type` 'hw-obs' | 'aws-s3' | 'azure-blob' | 'ceph-s3' | 'gcp-s3' | 'fusionstorage-object' | 'ibm-cos' | 'yig' | 'aws-file' | 'azure-file' — The backend type.
  - `region` string
  - `endpoint` string
  - `access` string
  - `security` string

## Response `200`

successful operation

- Backend
  - `id` string — The backend ID, generated by server
  - `tenantId` string — The tenant UUID in a multi-tenancy environment.
  - `userId` string — The user UUID in a multi-tenancy environment.
  - `name` string — The backend name specified by user.
  - `type` 'hw-obs' | 'aws-s3' | 'azure-blob' | 'ceph-s3' | 'gcp-s3' | 'fusionstorage-object' | 'ibm-cos' | 'yig' | 'aws-file' | 'azure-file' — The backend type.
  - `region` string
  - `endpoint` string
  - `access` string
  - `security` string

## Other responses

- `401` — Unauthorized. Token not found in header
- `415` — Unsupported Media Type

## Changes

> 33 revisions in range; 3 not diffed.

- **2021-12-27** `b348fb4e977f` — 20 warning, 15 info
  - removed the request property `Access`
  - removed the request property `BucketName`
  - removed the request property `Endpoint`
  - removed the request property `Id`
  - …31 more
- **2020-06-26** `443f565555ae` — 2 warning, 4 info
  - added the new `aws-file` enum value to the `Type` response property for the response status `200`
  - added the new `azure-file` enum value to the `Type` response property for the response status `200`
  - api tag `Backend` added
  - api tag `backend` removed
  - …2 more
- **2020-06-09** `bec7a127bf7f` — 1 info
  - endpoint added
- **2020-05-03** `f9da14548ae5` — 1 breaking
  - api path removed without deprecation
- **2018-11-01** `56dbe50974ed` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/changes/v1/:tenantId/backends/post.md)

---

[API](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api.md) · [All operations](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sodafoundation/soda-multi-cloud-api/revisions/df048c8349b6/schema)