---
title: "Update storage backend"
method: PUT
path: "/storage-backends/{id}"
tags: ["StorageBackend"]
---

# Update storage backend

`PUT /storage-backends/{id}`

Update a storage backend's mutable fields (name, credentials, status). Provider and physical location (endpoint, region, bucket, path prefix) are immutable; use storage migration to move data. Environment-sourced backends are read-only. Redacted secret placeholders preserve the stored credentials.

## Path parameters

- `id` string, required

## Request body

- InternalHandlerStorageBackendRequest
  - `config` GithubComTencentWeKnoraInternalTypesStorageBackendConfig
    - `access_key_id` string
    - `app_id` string
    - `bucket_name` string
    - `endpoint` string
    - `force_path_style` boolean
    - `mode` string
    - `path_prefix` string
    - `region` string
    - `secret_access_key` string
    - `temp_bucket_name` string
    - `temp_region` string
    - `use_ssl` boolean
    - `use_temp_bucket` boolean
  - `name` string, required
  - `provider` string, required
  - `status` string

## Response `200`

Updated storage backend

- object

## Other responses

- `400` — Immutable field change, read-only backend, validation, or connectivity failure
- `401` — Unauthorized
- `404` — Storage backend not found

---

[API](https://skmtc.net/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.net/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/abce9036def5/schema)