> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UpdateReturnLineItem

> Updates a specific line item of an existing return - state, quantity, return reason and its comment, condition and its comment, and the credit flag. The state of the return is inferred from the states of its line items.

If a request with this mutation's Idempotency-Key was already completed, the response's `extensions` contains an `idempotency.{responseName}` entry with `wasReplayed: true`.



**mutation** `UpdateReturnLineItem(request: UpdateReturnLineItemCommandRequestInput!): ReturnLineItem!`

## Arguments

**`request`**: `UpdateReturnLineItemCommandRequestInput!` (required)

## Returns

`ReturnLineItem!`

**`id`**: `ID!`

Unique ID to identify a return line item.

---

**`returnId`**: `ID!`

Unique ID to identify a return.

---

**`stateId`**: `ID!`

The ID of the return line item state.

---

**`itemId`**: `ID!`

Unique ID to identify an item.

---

**`name`**: `String!`

Name of the position.

---

**`itemNumber`**: `String!`

The item number of the line item.

---

**`quantity`**: `Decimal!`

The quantity of the line item.

---

**`returnReasonId`**: `ID!`

Unique ID to identify a return reason.

---

**`returnReasonComment`**: `String!`

The comment corresponding to the return line item reason.

---

**`conditionId`**: `ID!`

Unique ID to identify a condition.

---

**`conditionComment`**: `String!`

The comment corresponding to the return line item condition.

---

**`credit`**: `Boolean!`

Indicates whether this return line item should be credited.

---

**`salesOrderId`**: `ID!`

Unique ID to identify a sales order.

---

**`salesOrderLineItemId`**: `ID!`

Unique ID to identify a sales order item.

---

**`deliveryNoteLineItemId`**: `ID!`

Unique ID to identify a delivery note item.

## Examples

```graphql Mutation
mutation UpdateReturnLineItem($request: UpdateReturnLineItemCommandRequestInput!) {
  UpdateReturnLineItem(request: $request) {
    id
    returnId
    stateId
    itemId
    name
    itemNumber
  }
}
```

```json Variables
{
  "request": {
    "returnId": "id",
    "lineItemId": "id"
  }
}
```

```json Response
{
  "data": {
    "UpdateReturnLineItem": {
      "id": "id",
      "returnId": "id",
      "stateId": "id",
      "itemId": "id",
      "name": "string",
      "itemNumber": "string"
    }
  }
}
```
