Storage

Test a storage destination

Writes, reads back and deletes a small probe object from the region that owns the workspace. 200 with ok: false means the credentials or the bucket policy are wrong — steps[] says which check failed. The result is also stored as last_test.

post/v1/storage-destinations/{destination_id}/test

Request

  • Base URL: https://api-eu.dynamicdocumentapi.com
  • URL: https://api-eu.dynamicdocumentapi.com/v1/storage-destinations/{destination_id}/test
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

destination_idstring required

Storage destination id (dst_…).

Headers

Idempotency-Keystring

Replays the stored response for 24 h; a different body with the same key → 422.

Response

The probe ran; check ok.

host_keystring

SFTP: the SHA-256 fingerprint of the host key the server showed (SHA256:…). When it isn't config.host_key, the host_key step fails; update config.host_key once you checked it.

objectstring
okboolean required

Changes

No recorded changes to this operation across all 2 revisions of this API.