---
title: "Test storage backend by ID"
method: POST
path: "/storage-backends/{id}/test"
tags: ["StorageBackend"]
---

# Test storage backend by ID

`POST /storage-backends/{id}/test`

Test connectivity of an existing saved storage backend using its stored credentials. Returns success=false with a sanitized error message on failure (the HTTP status stays 200).

## Path parameters

- `id` string, required

## Response `200`

Connectivity test result (success, error)

- object

## Other responses

- `401` — Unauthorized
- `404` — Storage backend not found

## Changes

- **2026-07-15** `b2cfb8156e2e` — 1 info
  - endpoint added
- **2025-12-16** `edf61e68559d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/storage-backends/:id/test/post.md)

---

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