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

# Delete Invoice

> Permanently deletes an invoice. Only invoices with `Draft` status can be deleted.

### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_API_KEY`
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  UUID of the invoice to delete.
</ParamField>

<Warning>
  This action is irreversible. To cancel a sent invoice, use [Update Invoice](/api-reference/invoices/update) to set its status to `Cancelled` instead.
</Warning>

### Response

<ResponseField name="success" type="boolean">`true` on deletion.</ResponseField>
<ResponseField name="message" type="string">`"Invoice deleted"`</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://kliio.app/api/v1/invoices/inv-uuid-... \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```js JavaScript theme={null}
  const res = await fetch('https://kliio.app/api/v1/invoices/inv-uuid-...', {
    method: 'DELETE',
    headers: { Authorization: 'Bearer YOUR_API_KEY' }
  })
  const result = await res.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Invoice deleted"
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Can only delete invoices with Draft status"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Invoice not found or access denied"
  }
  ```
</ResponseExample>