Update Invoice

Update an existing invoice

This endpoint updates an existing invoice. Only draft invoices can have their line items modified. Sent invoices can only update certain fields.

Authentication

This endpoint requires a valid API key with invoices:write permissions.

Authorization: Bearer YOUR_API_KEY

Path Parameters

id · string · required

The unique identifier of the invoice

Request Body

due_date · string

Update due date (YYYY-MM-DD)

payment_terms · string

Update payment terms

notes · string

Update invoice notes

line_items · array

Update line items (draft invoices only)

billing_address · object

Update billing address

metadata · object

Update custom fields

Response

Returns the updated invoice object.

cURL

curl --location --request PUT 'https://api.stateset.com/v1/invoices/inv_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "due_date": "2024-02-28",
    "payment_terms": "Net 45",
    "notes": "Updated payment terms as discussed"
}'

Response

{
  "id": "inv_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "invoice",
  "invoice_number": "INV-2024-0001",
  "status": "sent",
  "updated_at": "2024-01-20T11:00:00Z",
  "due_date": "2024-02-28",
  "payment_terms": "Net 45",
  "notes": "Updated payment terms as discussed",
  "total_amount": 697500,
  "amount_due": 697500,
  "days_until_due": 40
}