Workspaces

Validate a storage connection

Start a storage_validation job that checks Nace can write, read and delete in the destination, from both its API and its workers. Read it with GET /v1/storage-connections/{id}/validation-job; once it succeeds the connection is ready. A new IAM role or Azure role assignment can take a few minutes to apply, so a fresh one may fail at first. Free. Only where customer storage is on for the deployment; where it is off, every storage connection route answers 404 storage_connection_unavailable once the API key is accepted, before checking the request or its body.

post/v1/storage-connections/{id}/validate

Request

Path parameters

idstring uuid required

The connection's id.

Request body

reactivateboolean

Restore a connection you revoked once the validation passes.

Response

The validation job.

job_idstring uuid required
kindstring required

The document service's job kind, such as ingestion, reconciliation, kg_build, intelligent_search (automatic search), automatic_agent (QA), file_replace, file_delete or workspace_delete.

status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
workspace_idstring
resultunknown

Changes

No recorded changes to this operation across all 1 revision of this API.