v1
latestOpenAPI 3.0.12026-07-24310590875.6 KBinvoices
Replace an invoice
Update the number of line items in an invoice. You can also update other invoice details.
You can use the PUT operation to add, remove, or replace the number of line items in an invoice. A set of rules apply with the PUT operation.
- When you add a new line item, a new line item id is generated in the invoice.
- When you omit an existing line item id, the line item is removed from the invoice.
put/v3/invoices/{invoiceId}
Path parameters
invoiceIdstring required
BILL-generated ID of the invoice. The value begins with 00e.
Example:{{invoice_id}}
Headers
sessionIdstring nullable
API session ID generated with /v3/login
Example:{{session_id}}
devKeystring nullable
Developer key generated with your BILL developer account
Example:{{developer_key}}
Request body
Example request
{
"customer": {
"id": "{{customer_id}}"
},
"invoiceLineItems": [
{
"description": "Premium drummer gloves",
"amount": 29.99,
"quantity": 1
},
{
"id": "{{invoice_line_item_id01}}",
"description": "Classic extreme drum sticks",
"price": 14.99,
"quantity": 2
},
{
"id": "{{invoice_line_item_id02}}",
"description": "Metal guitar picks (5-pack)",
"price": 50,
"quantity": 1
}
]
}Response
Replace an invoice response