> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dolfinai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Approval policies and voiding bills

> Automate bill approvals with policies, void bills outright, and read client-level settings for an organisation.

<Update label="2026-06-17" tags={["Feature","Release"]} description="Approvals and bill controls">
  ## New

  ### Approval policies

  Automate how bills move through review. [Create approval policies](/api-reference/endpoint/approvalpolicies/create-approval-policy) for an organisation that are evaluated when a bill is submitted for review — to auto-approve it, route it for manual review, or auto-void it. [List](/api-reference/endpoint/approvalpolicies/list-approval-policies) policies in priority order, [fetch](/api-reference/endpoint/approvalpolicies/get-approval-policy) a single one, [update](/api-reference/endpoint/approvalpolicies/update-approval-policy) its configuration, or [delete](/api-reference/endpoint/approvalpolicies/delete-approval-policy) it. In-flight bills are unaffected by later changes — each bill carries a snapshot of the decision made at submit time.

  ### Void a bill

  [Void a bill](/api-reference/endpoint/bills/void-bill) outright, with an optional reason. Available from the `OcrFailed`, `PendingReview`, `NeedsApproval`, and `Rejected` states. Voiding is terminal — start over with a fresh upload.

  ### Client settings for an organisation

  Read the [client-level settings](/api-reference/endpoint/clients/get-client-settings-for-the-callers-organisation) — branding and feature flags — for the Client that owns the caller's active Organisation. Use it in Organisation-facing UIs to toggle behaviour, such as hiding the invoice email composer when the Client has AR emails disabled.

  ## Updates

  ### Gmail OAuth and AP settings

  The Gmail OAuth callback (`POST /gmail-connections/oauth-callback`) and `PATCH /settings/ap` endpoints have been removed. Accounts-payable settings are still readable via [`GET /settings/ap`](/api-reference/endpoint/organisations/get-ap-settings).
</Update>