---
title: "Test a storage connection"
method: POST
path: "/storage/{id}/test"
tags: ["Storage"]
---

# Test a storage connection

`POST /storage/{id}/test`

Writes a zero-byte marker, reads it back and deletes it. `ok` reflects the write check; a failed read means sources from this storage will fail; a skipped delete means the connection cannot delete, which is the setup we recommend.

## Path parameters

- `id` string, required

## Response `200`

Probe result

- object
  - `data` object, required
    - `ok` boolean, required
    - `checks` object[], required
      - `name` 'write' | 'read' | 'delete' | 'list', required
      - `status` 'passed' | 'failed' | 'skipped', required
      - `reason` 'destination_denied' | 'signature_mismatch' | 'bucket_not_found' | 'object_too_large' | 'already_exists' | 'destination_unavailable' | 'not_deliverable'
      - `message` string

## Other responses

- `401` — Unauthorized
- `403` — Missing scope or role
- `404` — Not found

## Changes

- **2026-09-13** `e2df91eff7a2` — 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/rendobar/apis/rendobar-api.md) · [All operations](https://skmtc.dev/rendobar/apis/rendobar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rendobar/apis/rendobar-api/revisions/14f92fdd491f?raw)