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

# Replace Warranty Item

> This endpoint processes a replacement for a warranty claim.

### Body

<ParamField body="warranty_id" type="string">
  The ID provided in the data tab may be used to identify the warranty
</ParamField>

<ParamField body="replacement_product_id" type="string">
  The product ID of the replacement item
</ParamField>

<ParamField body="replacement_reason" type="string">
  The reason for the replacement
</ParamField>

<ParamField body="shipping_address" type="object">
  The shipping address for the replacement item
</ParamField>

<ParamField body="expedited_shipping" type="boolean">
  Whether to use expedited shipping for the replacement
</ParamField>

### Response

<ResponseField name="id" type="string">
  The ID provided in the data tab may be used to identify the warranty
</ResponseField>

<ResponseField name="object" type="string">
  The object type
</ResponseField>

<ResponseField name="replacement_order_id" type="string">
  The order ID for the replacement item
</ResponseField>

<ResponseField name="replacement_product_id" type="string">
  The product ID of the replacement item
</ResponseField>

<ResponseField name="replacement_status" type="string">
  The status of the replacement (e.g., "pending", "shipped", "delivered")
</ResponseField>

<ResponseField name="tracking_number" type="string">
  The tracking number for the replacement shipment
</ResponseField>

<ResponseField name="estimated_delivery" type="string">
  The estimated delivery date for the replacement
</ResponseField>

<ResponseField name="success" type="number">
  Indicates whether the call was successful. true if successful, false if not.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://api.stateset.com/v1/warranties/:id/replace' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Token <token>' \
  --data-raw '{
      "id": "e0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
      "replacement_product_id": "prod_xyz789",
      "replacement_reason": "Manufacturing defect",
      "shipping_address": {
          "line1": "123 Main St",
          "city": "New York",
          "state": "NY",
          "postal_code": "10001",
          "country": "US"
      },
      "expedited_shipping": true
  }'
  ```

  ```graphQL GraphQL theme={null}
        mutation warrantyReplaceMutation {
          warrantyReplace(
            id: "${warrantyId}",
            replacementProductId: "${replacementProductId}",
            replacementReason: "${replacementReason}",
            shippingAddress: ${shippingAddress},
            expeditedShipping: ${expeditedShipping}
          ) {
            warranty {
              id,
              status,
              replacement_order_id,
              replacement_status,
              tracking_number
            }
            userErrors {
              field
              message
            }
          }
        }
      `;
  ```

  ```js Node.js theme={null}
  const warranties = await stateset.warranties.replace({
    id: '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    replacement_product_id: 'prod_xyz789',
    replacement_reason: 'Manufacturing defect',
    shipping_address: {
      line1: '123 Main St',
      city: 'New York',
      state: 'NY',
      postal_code: '10001',
      country: 'US'
    },
    expedited_shipping: true
  });
  ```

  ```python Python theme={null}
  warranties = stateset.warranties.replace({
    'id': '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    'replacement_product_id': 'prod_xyz789',
    'replacement_reason': 'Manufacturing defect',
    'shipping_address': {
      'line1': '123 Main St',
      'city': 'New York',
      'state': 'NY',
      'postal_code': '10001',
      'country': 'US'
    },
    'expedited_shipping': True
  })
  ```

  ```ruby Ruby theme={null}
  warranties = Stateset::Warranty.replace({
    id: '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    replacement_product_id: 'prod_xyz789',
    replacement_reason: 'Manufacturing defect',
    shipping_address: {
      line1: '123 Main St',
      city: 'New York',
      state: 'NY',
      postal_code: '10001',
      country: 'US'
    },
    expedited_shipping: true
  })
  ```

  ```go Go theme={null}
  warranties, err := stateset.Warranties.replace({
    ID: '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    ReplacementProductID: 'prod_xyz789',
    ReplacementReason: 'Manufacturing defect',
    ShippingAddress: Address{
      Line1: '123 Main St',
      City: 'New York',
      State: 'NY',
      PostalCode: '10001',
      Country: 'US'
    },
    ExpeditedShipping: true
  })
  ```

  ```java Java theme={null}
  Warranty warranties = stateset.Warranties.replace({
    id: '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    replacementProductId: 'prod_xyz789',
    replacementReason: 'Manufacturing defect',
    shippingAddress: {
      line1: '123 Main St',
      city: 'New York',
      state: 'NY',
      postalCode: '10001',
      country: 'US'
    },
    expeditedShipping: true
  });
  ```

  ```php PHP theme={null}
  $warranties = $stateset->warranties->replace([
    'id' => '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    'replacement_product_id' => 'prod_xyz789',
    'replacement_reason' => 'Manufacturing defect',
    'shipping_address' => [
      'line1' => '123 Main St',
      'city' => 'New York',
      'state' => 'NY',
      'postal_code' => '10001',
      'country' => 'US'
    ],
    'expedited_shipping' => true
  ]);
  ```

  ```csharp C# theme={null}
  var warranties = await stateset.Warranties.Replace(new {
    Id = '0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
    ReplacementProductId = 'prod_xyz789',
    ReplacementReason = 'Manufacturing defect',
    ShippingAddress = new {
      Line1 = '123 Main St',
      City = 'New York',
      State = 'NY',
      PostalCode = '10001',
      Country = 'US'
    },
    ExpeditedShipping = true
  });
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "e0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
    "object": "warranty",
    "replaced": true,
    "replacement_order_id": "ord_repl_123abc",
    "replacement_product_id": "prod_xyz789",
    "replacement_status": "shipped",
    "tracking_number": "1Z999AA10123456784",
    "estimated_delivery": "2024-01-18",
    "replacement_reason": "Manufacturing defect"
  }
  ```
</ResponseExample>