---
title: "Update a backend."
method: PUT
path: "/v1/{tenantId}/backends/{backendId}"
tags: ["Backend"]
---

# Update a backend.

`PUT /v1/{tenantId}/backends/{backendId}`

## Request body

- object
  - `access` string — Updated the specified backend access Id
  - `security` string — Updated the specified backend security Id

## 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
- `404` — The resource does not exist.

## Changes

> 33 revisions in range; 3 not diffed.

- **2021-12-27** `b348fb4e977f` — 12 warning, 11 info
  - removed the request property `Access`
  - removed the request property `Security`
  - removed the optional property `Access` from the response with the `200` status
  - removed the optional property `BucketName` from the response with the `200` status
  - …19 more
- **2020-06-26** `443f565555ae` — 2 warning, 2 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
- **2020-06-09** `bec7a127bf7f` — 1 info
  - endpoint added
- **2018-10-29** `50fa096a3906` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/changes/v1/:tenantId/backends/:backendId/put.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)