---
title: "PUT /openapi/{version}/consignments/inbound_consignments/{id}/"
method: PUT
path: "/openapi/{version}/consignments/inbound_consignments/{id}/"
tags: ["Inbound Consignment"]
---

# PUT /openapi/{version}/consignments/inbound_consignments/{id}/

`PUT /openapi/{version}/consignments/inbound_consignments/{id}/`

## Request

- Base URL: `https://base_url`
- URL: `https://base_url/openapi/{version}/consignments/inbound_consignments/{id}/`
- Auth: none declared

This endpoint allows you to update an existing inbound consignment. The following fields can be updated: - `tracking_number`, `carrier_name`, `tracking_url`, `estimated_arrival_date`, `asn_note`, and the existing list of products while creation. Please save the **task_id** returned in the response. 

**Note**: Updation of Inbound Consignment Products is asynchronous in this API. This will return the task ID which is submitted to update the Inbound Consignment Products. 

To know the status of the task, you can do one of the following:-, 
1. Use [**Get Bulk Create or Update Status API**](#operation/Get%20Bulk%20Create%20or%20Update%20Status) by providing the task ID.

     **OR**
2. Subscribe to the **InboundProductBulkUploadStatus** callback type in [**Seller Webhooks**](#operation/create-callback-subscription) section.

<b>Example `curl` Request:</b>
```bash
curl --location --request PUT '{{url}}/openapi/v2/consignments/inbound_consignments/17049' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
    "tracking_number": "new-tracking-number",
    "carrier_name": "new-carrier-name",
    "tracking_url": "https://tracking-url.com",
    "estimated_arrival_date": "2024-12-01",
    "asn_note": "Updated ASN note",
    "products": [
        {
            "sku": "INV_SKU_ITEM00099",
            "consignment_quantity": 15,
            "expiry_date": "2026-12-01"
        }
    ]
}'
```

## Path parameters

- `id` string, required
- `version` string, required

## Request body

- InboundConsignmentUpdateOpenAPI
  - `tracking_number` string: Tracking Number
  - `carrier_name` string: Carrier Name
  - `tracking_url` string: Tracking URL
  - `estimated_arrival_date` string, date, nullable: Estimated arrival date
  - `asn_note` string, nullable: ASN Note
  - `products` InboundConsignmentProductOpenAPI[]
    - `sku` string, required: SKU
    - `consignment_quantity` integer, required: Quantity
    - `expiry_date` string, date, nullable: Expiry Date

## Response `200`

- EnvelopedInboundConsignmentTaskStatusOpenAPI
  - `success` boolean
  - `data` InboundConsignmentTaskStatusOpenAPI, required
    - `task_status` TaskStatus, required
      - `task_id` integer, required
      - `status` string, required
    - `inbound_consignment_id` integer, required: inbound consignment ID
  - `message` string, required

## Other responses

- `400`: Bad Request - Invalid input.
- `401`: Unauthorized - Invalid or expired credentials.
- `403`: Forbidden - You do not have permission to access this resource.
- `404`: Not Found - The requested resource does not exist.
- `500`: Internal Server Error - Unexpected error occurred.

---

[API](https://skmtc.dev/golocad/apis/locad-api.md) - [All operations](https://skmtc.dev/golocad/apis/locad-api/llms.txt) - [OpenAPI document](https://skmtc.dev/golocad/apis/locad-api/revisions/428200f33a81?raw)