Generate Invoice Now

Manually trigger invoice generation for this organization.

Useful for testing the billing flow or generating retroactive invoices. Requires ADMIN permission.

Line items follow the v2 (modality+features, D8) composition: flat monthly fee + per-modality feature usage in natural units and dollars + the plan's included-usage pool as a deduction; only usage beyond the pool is due. The total always reconciles to the month's ledger charges (see pricing_v2).

Example:

# Dry run
response = await client.post(
    "/v1/organizations/billing/generate-invoice",
    json={"dry_run": true}
)

# Actually generate
response = await client.post(
    "/v1/organizations/billing/generate-invoice",
    json={"billing_month": "2026-01"}
)