Skip to main content
DELETE
Delete a provider connection and its stored secrets

Authorizations

Authorization
string
header
required

A Barndoor API key, sent as Authorization: Bearer <key>. Keys are prefixed bdai_ and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token.

Path Parameters

name
string
required

Provider name, e.g. google_dlp

Response

Deleted. Also returned when no such connection exists — the handler is idempotent and does not distinguish the two. Removing a connection a detection engine still references succeeds; nothing enforces that reference

The error body every /admin/v1 handler returns.

Two shapes reach the wire and both are modelled here as optional fields: the shared auth/role gate in [super] emits {"error": ...}, while [super::json_message] — which the handlers themselves use — emits {"message": ...}. Exactly one is present on any given response. This is documentation of what the service already does, not a new contract; a handler is not free to send both.

error
string | null

Set by the authentication and tenant-admin role gate (401 and 403).

message
string | null

Set by handler-level validation and store failures.