# kindgi approvals > Review HITL approvals, and export their signed audit bundles ## `kindgi approvals` **Synopsis** ```sh signature kindgi approvals ``` Review HITL approvals, and export their signed audit bundles. **Commands** | Command | Description | | ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | | [`kindgi approvals list`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals-list) | List the approvals your reviewer role can see. | | [`kindgi approvals get`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals-get) | Fetch an approval by id. | | [`kindgi approvals complete`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals-complete) | Decide an approval. | | [`kindgi approvals export`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals-export) | Export a decided approval's audit bundle, signed with the deployment's export key: who decided, when, why, and its evidence. | **See also** - [Set approval rules for every agent](https://docs.kindgi.com/v0.1.8/guides/approvals/approval-rules-for-every-agent.md) - [Ask before a long conversation continues](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-after-n-turns.md) - [Ask before a tool runs](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-before-a-tool-runs.md) - [Decide an approval](https://docs.kindgi.com/v0.1.8/guides/approvals/decide-an-approval.md) ### `kindgi approvals list` **Synopsis** ```sh signature kindgi approvals list [--status=[,…]] [--assigned-to=me] [--order=asc|desc] [--limit=] [--cursor=] ``` List the approvals your reviewer role can see. **Options** | Option | Default | Description | | ----------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--assigned-to ` | none (all approvals your role can see) | `me`: only the approvals assigned to you. | | `--cursor ` | none | Resume after this cursor, from the previous page's `nextCursor`. | | `--limit ` | `25` (at most `100`) | The most approvals to return (default 25, at most 100). | | `--order ` | `desc` (newest first) | `asc` (oldest first) or `desc` (newest first, the default). | | `--status ` | none (every status) | Only approvals in these statuses, comma-separated (`pending,assigned,in_review` are the open ones): `pending`, `assigned`, `in_review`, `approved`, `rejected`, `escalated`, `expired` or `withdrawn`. | Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags). **Examples** From [Set approval rules for every agent](https://docs.kindgi.com/v0.1.8/guides/approvals/approval-rules-for-every-agent.md): ```sh pnpm exec kindgi approvals list --status=pending ``` From [Decide an approval](https://docs.kindgi.com/v0.1.8/guides/approvals/decide-an-approval.md): ```sh pnpm exec kindgi approvals list --status=assigned,in_review --assigned-to=me --order=asc ``` **See also** - [Set approval rules for every agent](https://docs.kindgi.com/v0.1.8/guides/approvals/approval-rules-for-every-agent.md) - [Ask before a long conversation continues](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-after-n-turns.md) - [Ask before a tool runs](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-before-a-tool-runs.md) - [Decide an approval](https://docs.kindgi.com/v0.1.8/guides/approvals/decide-an-approval.md) - [`kindgi approvals`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals) ### `kindgi approvals get` **Synopsis** ```sh signature kindgi approvals get ``` Fetch an approval by id. **Options** Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags). **Examples** From [Decide an approval](https://docs.kindgi.com/v0.1.8/guides/approvals/decide-an-approval.md): ```sh pnpm exec kindgi approvals get ``` **See also** - [Decide an approval](https://docs.kindgi.com/v0.1.8/guides/approvals/decide-an-approval.md) - [`kindgi approvals`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals) ### `kindgi approvals complete` **Synopsis** ```sh signature kindgi approvals complete --decision=approve|reject|escalate|withdraw [--rationale=] ``` Decide an approval. Approving or rejecting resumes the run that waits on it (and the flow it is a step of). **Options** | Option | Default | Description | | --------------------- | -------- | ---------------------------------------------------------------------- | | `--decision ` | required | The decision: `approve`, `reject`, `escalate` or `withdraw`. Required. | | `--rationale ` | none | Why, recorded with the decision. | Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags). **Examples** From [Ask before a long conversation continues](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-after-n-turns.md): ```sh pnpm exec kindgi approvals complete --decision=approve pnpm exec kindgi approvals complete ff98fdd3-5d1d-4245-bdab-2ab9971f3962 --decision=reject --rationale="Hand this one to a person" ``` **See also** - [Ask before a long conversation continues](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-after-n-turns.md) - [Ask before a tool runs](https://docs.kindgi.com/v0.1.8/guides/approvals/ask-before-a-tool-runs.md) - [Decide an approval](https://docs.kindgi.com/v0.1.8/guides/approvals/decide-an-approval.md) - [Release an agent version](https://docs.kindgi.com/v0.1.8/guides/evals/release-an-agent-version.md) - [`kindgi approvals`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals) ### `kindgi approvals export` **Synopsis** ```sh signature kindgi approvals export [--signing-key=] [--include-messages] > bundle.json ``` Export a decided approval's audit bundle, signed with the deployment's export key: who decided, when, why, and its evidence. Check it with kindgi exports verify. **Options** | Option | Default | Description | | ----------------------- | --------------------------- | --------------------------------------------------------------------------------- | | `--include-messages` | none | Add the conversation messages of the approval's run. | | `--signing-key ` | the deployment's active key | Sign with this key (one the runtime lists). Default: the deployment's active key. | Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags). **Examples** From [Export signed evidence](https://docs.kindgi.com/v0.1.8/guides/observability/export-signed-evidence.md): ```sh pnpm exec kindgi approvals export 0b6e3c1e-2f4f-4a51-9d0e-7a1f2c3d4e5f > approval.json ``` **See also** - [Export signed evidence](https://docs.kindgi.com/v0.1.8/guides/observability/export-signed-evidence.md) - [`kindgi approvals`](https://docs.kindgi.com/v0.1.8/reference/cli/approvals.md#kindgi-approvals)