Delete a draft invoice

Deletes a draft. Deleting an issued invoice voids it instead.

DELETE/v1/invoices/{id}

Requires invoices:write permission.

idstringrequired

The id of the invoice (inv_…).

Example: inv_01k7q3m8x2v5t9n4b6c1d0e7fa

Prefixed with inv_.

dataobjectrequired

The returned object, or an array of objects for a list.

idstringrequired

The id of the invoice (inv_…).

Example: inv_01k7q3m8x2v5t9n4b6c1d0e7fa

Prefixed with inv_.

deletedstringrequired

Always true: the object has been deleted.

Value: true

metaobjectrequired

Request details such as its id and pagination cursor.

request_idstringrequired

The id of this request. Quote it when you ask support about it.

Example: req_Hy3k9QzT2LmN8vXa

A failed request answers with the common error shape; see Errors.

curl -X DELETE "https://api.baiyar.com/v1/invoices/{id}" \
  -H "Authorization: Bearer $BAIYAR_KEY"

{
  "data": {
    "id": "inv_01k7q3m8x2v5t9n4b6c1d0e7fa",
    "deleted": true
  },
  "meta": {
    "request_id": "req_Hy3k9QzT2LmN8vXa"
  }
}