---
title: "Delete a custom invoice in DRAFT state"
method: DELETE
path: "/invoices/{invoice_id}"
tags: ["Invoices"]
---

# Delete a custom invoice in DRAFT state

`DELETE /invoices/{invoice_id}`

## Request

- Base URL: `https://api.togai.com`
- URL: `https://api.togai.com/invoices/{invoice_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/togaihq/apis/togai-apis/docs/invoices/:invoice_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a custom invoice in DRAFT state.

## Path parameters

- `invoice_id` string, required

## Response `200`

OK

- BaseSuccessResponse
  - `success` boolean, required

## Other responses

- `401`: Error response
- `403`: Error response
- `404`: Error response
- `429`: Error response
- `default`: Error response

## Changes

- **2024-03-01** `6fb940b0dad9`: 6 breaking, 15 warning, 1 info
  - removed the required property `id` from the response with the `200` status
  - removed the required property `invoiceClass` from the response with the `200` status
  - removed the required property `invoiceDate` from the response with the `200` status
  - removed the required property `invoiceType` from the response with the `200` status
  - …18 more
- **2024-01-05** `ea9c4628bfdb`: 1 info
  - added the optional property `endDateInclusive` to the response with the `200` status
- **2023-12-22** `edb9ea013bb1`: 1 warning
  - added the new `PARTIALLY_PAID` enum value to the `status` response property for the response status `200`
- **2023-11-30** `b3351be4b462`: 1 info
  - endpoint added
- **2023-09-02** `6b13f6f47735`: 1 breaking
  - api removed without deprecation

[Operation history](https://skmtc.dev/togaihq/apis/togai-apis/changes/invoices/:invoice_id/delete.md)

---

[API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [All operations](https://skmtc.dev/togaihq/apis/togai-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/togaihq/apis/togai-apis/revisions/442f5d8f4aa0?raw)