Delete Invoice

delete/v1/invoices/{invoice_id}

Soft-deletes an invoice within the active workspace by setting deleted_at. Side effects: the invoice stops appearing in list and retrieve responses; related line items are cascaded per the soft-delete contract. Idempotent on an already-deleted invoice.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
invoice_id	string <uuid>	Yes	Public UUID of the invoice to delete.e.g. 11111111-0000-4000-8000-0000000000b1

Request

cURL

curl -X DELETE https://api.wellapp.ai/v1/invoices/{invoice_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

204 — The invoice was soft-deleted. No content is returned.

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}