---
title: "Convert Proposal To Invoice"
method: POST
path: "/api/proposals/{proposal_id}/convert-to-invoice"
tags: ["proposals"]
---

# Convert Proposal To Invoice

`POST /api/proposals/{proposal_id}/convert-to-invoice`

Convert an issued/approved proposal, or recover its existing invoice.

## Path parameters

- `proposal_id` string, uuid, required

## Headers

- `X-Expected-Org-Id` string, nullable

## Request body

- ProposalLifecycleCommand
  - `operation_id` string, uuid, required
  - `expected_updated_at` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-10** `fa3b495a731d` — 1 breaking, 1 info
  - added required request body
  - added the new optional `header` request parameter `X-Expected-Org-Id`

[Change history](https://skmtc.dev/every/apis/every-api/changes/api/proposals/:proposal_id/convert-to-invoice/post.md)

---

[API](https://skmtc.dev/every/apis/every-api.md) · [All operations](https://skmtc.dev/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc.dev/every/apis/every-api/revisions/fa3b495a731d?raw)