---
search:
  tags:
    - Approval Policies
    - POST
seo:
  description: >-
    Read-only. Parses a policy file (YAML or JSON, at most 256 KiB, no…
    Reference for the POST /api/v2/approval-policies/files/plan endpoint in the
    Anlyon API.
sidebar:
  label: Plan a policy file
  badge: POST
title: Plan a policy file
type: openapi-operation
---
Read-only. Parses a policy file (YAML or JSON, at most 256 KiB, no duplicate keys or aliases), checks every policy (targets, CEL conditions against the action's input schema, name clashes, broad denies, the plan's policy allowance) and returns what applying it would create, update and delete. Only policies owned by this file are ever changed; console-made and other files' policies are never taken over. `errors` lists everything that prevents applying. `digest` identifies the reviewed state: pass it to apply, which refuses if anything changed since. The file must declare the credential's environment.

`POST /api/v2/approval-policies/files/plan`