Workspaces
Read a storage connection
Authorization
bearerAuth AuthorizationBearer <token>
Your API key, sent as Authorization: Bearer nace_sk_...
- Where: the dashboard's API Keys page. It is shown once, when you create it.
- Format:
nace_sk_followed by 43 URL-safe characters (A-Z,a-z,0-9,_and-). - Limit: an account can hold at most 3 active keys.
- Wrong or missing key: returns
401 authentication_error.
In: header
Path Parameters
idstringrequired
The connection's id.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/storage-connections/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "6b1f0c9e-2d4a-4e7b-9c3d-8a5e1f2b7c40", "name": "Audit evidence bucket", "destination": { "type": "s3", "bucket": "acme-audit-evidence", "region": "us-east-1", "prefix": "nace" }, "status": "ready", "can_manage": true, "external_id": "nace-6b1f0c9e2d4a4e7b", "aws_trusted_principal_arn": null, "aws_trusted_principal_arns": [ "arn:aws:iam::111122223333:role/ndi-api", "arn:aws:iam::111122223333:role/ndi-worker" ], "credentials_pending": false, "validation_running": false, "credential_generation": 0, "validated_at": "2026-10-26T10:05:00Z", "reactivation_requires_approval": false, "revoked_reason": null, "revoked_at": null, "created_at": "2026-10-26T10:00:00Z"}