---
title: "Create storage backend"
method: POST
path: "/storage-backends"
tags: ["StorageBackend"]
---

# Create storage backend

`POST /storage-backends`

Register a new object/file storage instance for the current workspace. The configuration is validated and a connectivity test is run before the backend is persisted.

## 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 `201`

Created storage backend

- object

## Other responses

- `400` — Invalid request, validation, or connectivity test failure
- `401` — Unauthorized
- `409` — A storage backend with this name already exists

---

[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/6e297e21afca/schema)