Update an invoice.

PATCH

/v1/invoices/{id}

curl --request PATCH \
  --url https://api.ridleypay.com/v1/invoices/architecto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "customer_name": "b", "customer_email": "zbailey@example.net", "customer_address": "i", "currency": "yvd", "due_date": "2026-09-30T22:37:54", "notes": "l", "terms": "j", "discount": 52, "tax_rate": 5, "metadata": null, "items": null }'

Updates a draft invoice. Only draft invoices can be modified.

Authorizations

• default

Parameters

Path Parameters

id

required

string

The ID of the invoice.

Example

architecto

Request Body

Media typeapplication/json

object

customer_name

Must not be greater than 255 characters.

string

Example

b

customer_email

Must be a valid email address. Must not be greater than 255 characters.

string

Example

zbailey@example.net

customer_address

Must not be greater than 1000 characters.

string

nullable

Example

i

currency

Must be 3 characters.

string

Example

yvd

due_date

Must be a valid date.

string

Example

2026-09-30T22:37:54

notes

Must not be greater than 2000 characters.

string

nullable

Example

l

terms

Must not be greater than 2000 characters.

string

nullable

Example

j

discount

Must be at least 0.

number

nullable

Example

52

tax_rate

Must be at least 0. Must not be greater than 100.

number

nullable

Example

5

metadata

object

Example

null

items

Must have at least 1 items.

Array<object>

object

description

This field is required when items is present. Must not be greater than 500 characters.

string

Example

Deserunt aut ab provident perspiciatis quo omnis nostrum.

quantity

This field is required when items is present. Must be at least 1.

integer

Example

61

unit_price

This field is required when items is present. Must be at least 0.01.

number

Example

61

Example

null

Responses