Workspaces

Revoke a storage connection

POST
/v1/storage-connections/{id}/revoke

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.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/storage-connections/497f6eca-6276-4993-bfeb-53cbbbba6f08/revoke"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "destination": {    "type": "s3",    "bucket": "string",    "region": "string",    "prefix": ""  },  "status": "draft",  "can_manage": true,  "external_id": "string",  "aws_trusted_principal_arn": "string",  "aws_trusted_principal_arns": [    "string"  ],  "credentials_pending": true,  "validation_running": true,  "credential_generation": 0,  "validated_at": "2019-08-24T14:15:22Z",  "reactivation_requires_approval": true,  "revoked_reason": "owner",  "revoked_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z"}