A valid request URL is required to generate request examples{
"id": "<string>",
"object": "invoice_item",
"customer": "<string>",
"description": "<string>",
"quantity": 123,
"unit_amount": 123,
"amount": 123,
"currency": "<string>",
"invoice": "<string>",
"pending": true,
"metadata": {},
"created_at": 123,
"updated_at": 123,
"price": "<string>"
}{
"error": {
"code": "INVALID_DATA",
"message": "invalid currency"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "INVOICE_ITEM_NOT_FOUND",
"message": "invoice item not found"
}
}{
"error": {
"code": "INVOICE_ITEM_NOT_PENDING",
"message": "invoice item is already assigned to an invoice"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Update an invoice item
Updates the amount and description of a pending item. An item already drained onto an invoice cannot be updated.
A valid request URL is required to generate request examples{
"id": "<string>",
"object": "invoice_item",
"customer": "<string>",
"description": "<string>",
"quantity": 123,
"unit_amount": 123,
"amount": 123,
"currency": "<string>",
"invoice": "<string>",
"pending": true,
"metadata": {},
"created_at": 123,
"updated_at": 123,
"price": "<string>"
}{
"error": {
"code": "INVALID_DATA",
"message": "invalid currency"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "INVOICE_ITEM_NOT_FOUND",
"message": "invoice item not found"
}
}{
"error": {
"code": "INVOICE_ITEM_NOT_PENDING",
"message": "invoice item is already assigned to an invoice"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
Merchant ID when an authorized Platform acts for a connected Merchant. Omit when authenticating directly as that Merchant.
^mer_[0-9A-Za-z]{14}$A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
255Path Parameters
The invoice item id (ii_…).
Body
Response
The updated invoice item.
Unique identifier for the invoice item (ii_…).
invoice_item ID of the customer the item is billed to (cus_…).
The item's label, shown on the invoice line it becomes.
The number of units.
Per-unit price in minor units.
Total amount in minor units.
Three-letter ISO currency code.
The invoice this item was drained onto, or null while pending.
true while the item is not yet on an invoice (invoice is null), and false once it has been added to one.
Custom key-value pairs for your use.
Show child attributes
Show child attributes
Unix epoch seconds.
Unix epoch seconds when the invoice item was last updated.
The catalog price (price_…) the item was derived from. Null when the item was created without one.