Update Return Item | Ply | API Documentation

Updates the price, quantity, or note for a return line item.

Requires scope: returns:write

API_KEYstring

API Key authentication via header

idUUIDRequired

Return ID.

itemIdUUIDRequired

Return item ID.

This endpoint expects an object.

pricedoubleOptional

Updated unit price. Must be zero or greater.

deliveredQuantitydoubleOptional

Updated return quantity. Must be greater than zero.

notestringOptional

Updated note. Pass null to clear.

This endpoint returns an object.

idUUID

Unique identifier for this return item record.

materialobject

Reference to the parent material.

variationobject

Reference to the material variation, if applicable.

pricedouble

Unit price of the material at time of return.

deliveredQuantitydouble

Quantity being returned. Must be greater than zero.

notestring

Optional note for this line item.

createdAtdatetime

ISO 8601 timestamp when the record was created.

updatedAtdatetime

ISO 8601 timestamp when the record was last updated.

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X PUT https://api.getply.com/api/v1/returns/d6e7f8a9-b0c1-2345-defa-678901234567/items/e7f8a9b0-c1d2-3456-efab-789012345678 \
>	-H "API_KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"deliveredQuantity": 5
>	}'

1	{
2	"id": "e7f8a9b0-c1d2-3456-efab-789012345678",
3	"material": {
4	"id": "e5f6a7b8-c9d0-1234-efab-345678901234",
5	"name": "3/4 inch PVC Pipe (10ft)"
6	},
7	"variation": {
8	"id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
9	"name": null
10	},
11	"price": 25,
12	"deliveredQuantity": 5,
13	"note": "All five damaged on arrival",
14	"createdAt": "2026-03-20T10:00:00Z",
15	"updatedAt": "2026-03-20T15:00:00Z"
16	}