---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/parameter-values.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/parameter-values.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/parameter-values.md
  - href: en/step-by-step/parameter-values.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

# Transmitting characteristic values

In all scenarios, be guided by the data from the response of the method of obtaining characteristics. [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getCategoryContentParameters.md):
- `values[].id` — ids to send to `valueId`;
- `multivalue` — is it possible to pass multiple values;
- `allowCustomValues` — is it possible to pass custom values (`value` without `valueId`);
- `unit.defaultUnitId`, `unit.units[]` — units of measurement and their identifiers (`unitId`);
- `constraints` — restrictions on values (number limits, maximum text length).

The values are passed in the parameter `parameterValues` in two methods (the rules are the same):
- [POST v2/businesses/{businessId}/offer-mappings/update](https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/updateOfferMappings.md)
- [POST v2/businesses/{businessId}/offer-cards/update](https://yandex.com/dev/market/partner-api/doc/en/reference/content/updateOfferContent.md)

## A characteristic with a list of acceptable values (type `ENUM`), you need to specify one value
- When to apply: type characteristics `ENUM`, in the response of the characteristics method, the field `multivalue = false`.
- What to transmit: one object with `parameterId` and `valueId` (take the ID from `values[].id`). Field `value` you don't have to specify it.
- Restriction: if `allowCustomValues = false`, transfer only `value` without `valueId` will result in a validation error.

{% cut "Example — one value from the list" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "valueId": 999999, "value": "10" }
  ]
}
```

{% endcut %}

## The characteristic allows for eigenvalues, you need to specify one eigenvalue.
- When to apply: type characteristics `ENUM`, in the response of the characteristics method, the field `allowCustomValues = true`, `multivalue = false`.
- What to transmit: one object with `parameterId` and a line in `value`. Field `valueId` don't specify it.

{% cut "Example — one proper value" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "Собственное значение" }
  ]
}
```

{% endcut %}

## The characteristic allows for several values
- When to apply: in the response of the characteristics method, the field `multivalue = true`.
- What to transmit: multiple objects with the same name `parameterId` — one for each value.
  - If the value is from the Market list — specify `valueId`.
  - If eigenvalues are allowed (`allowCustomValues = true`) — specify `value` without `valueId`.

{% cut "Example — multiple eigenvalues" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "Собственное значение 1" },
    { "parameterId": 111111, "value": "Собственное значение 2" }
  ]
}
```

{% endcut %}

## Characteristics with units of measurement
- When to apply: units are indicated in the response for the characteristic (`unit.defaultUnitId`, `unit.units[]`).
- What to send: specify if necessary `unitId` in each object, the values are; if `unitId` omitted, the default unit is used.

{% cut "Example — value with a unit of measurement" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "10", "unitId": 3 }
  ]
}
```

{% endcut %}

## Deleting a previously passed value
- What to send: an object with the same name `parameterId` and empty `value` (`""`). This will delete the characteristic value.

{% cut "Example — deleting a feature value" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "" }
  ]
}
```

{% endcut %}