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.

Scopes

openid

Issue an OIDC ID token identifying the caller.

profile

Read the caller's basic profile claims.

email

Read the caller's email address.

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.