Skip to main content
GET
Get Affected Policies

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.

Query Parameters

agent_id
string | null

Agent (application) UUID. Mutually exclusive with mcp_server_id.

mcp_server_id
string | null

MCP server UUID. Mutually exclusive with agent_id.

Response

Successful Response

Response shape for GET /admin/v2/policies/affected-by.

Mirrors the cascade-handler buckets exactly: archive_* are policies that would transition to ARCHIVED, revise_* are policies that would have only their application_ids set-minus'd (only possible on agent_id queries — always 0/[] for mcp_server_id queries).

archive_count
integer
required
revise_count
integer
required
archive_preview
AffectedPolicyPreview · object[]
revise_preview
AffectedPolicyPreview · object[]