---
title: "UpdateChannelMapping"
method: POST
path: "/api/Inventory/UpdateChannelMapping"
tags: ["Inventory"]
---

# UpdateChannelMapping

`POST /api/Inventory/UpdateChannelMapping`

Use this call to update mappings between Linnworks items and channel items, such as Max Listed Quantity
<b>Permissions Required: </b> GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>150</b></span> / minute

## Request body

- UpdateChannelMappingRequest
  - `Mappings` ChannelMappingUpdateInfo[]
    - `Id` string, uuid, required — The unique id to identify the channel mapping
    - `ChannelReferenceId` string — Channel reference id. Not updated if not provided.
    - `MaxListedQuantity` integer — Maximum listed quantity. Always updated to the value from the request.
    - `EndWhenStock` integer — End listing when stock level. Always updated to the value from the request.
    - `StockPercentage` number, double — Stock percentage. Always updated to the value from the request.
    - `IgnoreSync` boolean — Ignore sync. Always updated to the value from the request.

## Response `200`

OK

- BatchedAPIResponseChannelMappingUpdateInfo
  - `Results` APIResultResponseChannelMappingUpdateInfo[]
    - `Result` ChannelMappingUpdateInfo
      - `Id` string, uuid, required — The unique id to identify the channel mapping
      - `ChannelReferenceId` string — Channel reference id. Not updated if not provided.
      - `MaxListedQuantity` integer — Maximum listed quantity. Always updated to the value from the request.
      - `EndWhenStock` integer — End listing when stock level. Always updated to the value from the request.
      - `StockPercentage` number, double — Stock percentage. Always updated to the value from the request.
      - `IgnoreSync` boolean — Ignore sync. Always updated to the value from the request.
    - `ResultStatus` 'NOTSET' | 'SUCCESSFUL' | 'PARTIALLY_SUCCESSFUL' | 'FAILED'
    - `Message` string
  - `TotalResults` integer
  - `ResultStatus` 'NOTSET' | 'SUCCESSFUL' | 'PARTIALLY_SUCCESSFUL' | 'FAILED'

---

[API](https://skmtc.net/linnworks/apis/authenticate-api.md) · [All operations](https://skmtc.net/linnworks/apis/authenticate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linnworks/authenticate-api/versions/0123569a22fb/schema)