Sign in
latestOpenAPI 3.1.02026-08-236994571.1 MB

79928a3d37d3

Policies

Estimate Attachment Impact

Estimate how many keys and teams would be affected by a policy attachment.

Use this before creating an attachment to preview the blast radius.

Example Request:

curl -X POST "http://localhost:4000/policies/attachments/estimate-impact" \
    -H "Authorization: Bearer <your_api_key>" \
    -H "Content-Type: application/json" \
    -d '{
        "policy_name": "hipaa-compliance",
        "tags": ["healthcare", "health-*"]
    }'
post/policies/attachments/estimate-impact

Request body

policy_namestring required

Name of the policy to attach.

scopestring nullable

Use '*' for global scope (applies to all requests).

teamsstring[] nullable

Team aliases or patterns this attachment applies to.

keysstring[] nullable

Key aliases or patterns this attachment applies to.

modelsstring[] nullable

Model names or patterns this attachment applies to.

tagsstring[] nullable

Tag patterns this attachment applies to. Supports wildcards (e.g., health-*).

Response

Successful Response

affected_keys_countinteger

Number of keys that would be affected (named + unnamed).

affected_teams_countinteger

Number of teams that would be affected (named + unnamed).

unnamed_keys_countinteger

Number of affected keys without an alias.

unnamed_teams_countinteger

Number of affected teams without an alias.

sample_keysstring[]

Sample of affected key aliases (up to 10).

sample_teamsstring[]

Sample of affected team aliases (up to 10).