Skip to content

cli reference

Intended Documentation

intended policy

Manage policy drafts, reviews, deployments, and rollbacks from the command line.

beginner1 min readimplemented

intended policy#

The intended policy command group mirrors the policy lifecycle API.

Core Commands#

intended policy drafts list

Lists drafts for a tenant.

bash
intended policy drafts list --tenant tenant_acme_prod --limit 20

intended policy drafts create

Creates a policy draft.

bash
intended policy drafts create \
  --tenant tenant_acme_prod \
  --pack prod-release-controls \
  --title "Require approval for prod deploy" \
  --file ./policies/prod-release-controls.json

intended policy drafts review

Submits a draft for review.

bash
intended policy drafts review draft_123 \
  --tenant tenant_acme_prod \
  --submitted-by user_operator \
  --comments "Ready for approver review"

intended policy drafts approve

Approves a draft in review.

bash
intended policy drafts approve draft_123 \
  --tenant tenant_acme_prod \
  --reviewer user_approver

intended policy deploy

Deploys an approved draft.

bash
intended policy deploy draft_123 \
  --tenant tenant_acme_prod \
  --deployed-by user_approver

intended policy rollback

Rolls back a deployed version.

bash
intended policy rollback version_456 \
  --tenant tenant_acme_prod \
  --rolled-back-by user_admin \
  --comments "Incident mitigation"

Warning

No direct delete endpoint exists for active policy versions. Use lifecycle controls (review/reject, deploy, rollback) instead of destructive deletion paths.

intended policy | Intended