---
title: "Test storage mount connection"
method: POST
path: "/storage_mounts/test"
tags: ["Document AI — Storage Mounts"]
---

# Test storage mount connection

`POST /storage_mounts/test`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/storage_mounts/test`
- Auth: HTTP bearer

Test whether a saved storage mount is reachable, or validate connector credentials before saving.

## Request body

- object
  - `mount_id` string: ID of an existing storage mount to test (omit when sending dry-run connector credentials in the body).
  - `connector_type` string: Connector type for dry-run test: `sftp`, `ftp`, `ftps`, `smb`, `webdav`, or `s3`.
  - `host` string: Hostname for dry-run connection test (example: `files.example.com`).
  - `port` string: Port for dry-run connection test (example: `22` for SFTP).
  - `username` string: Username for dry-run connection test.
  - `password` string: Password for dry-run connection test — use a placeholder in shared collections.

## Response `200`

Success

- object: Test storage-mount connection
  - `processing_time` string, required: Processing time (format: 123.45ms)
  - `connected` boolean: Connected
  - `message` string: Status message or error description
  - `latency_ms` number: Latency ms
  - `status` 'success' | 'error': Request status: "success" or "error"

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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