Update label

POST/api/crm/v2/labels.updatev2

operationId: labels.update

Updates a label. text_color and background_color are HEX values without the leading #.

Authorization

api-token + language + role

Query parameters

chain_idinteger

Example: 7124

Request body `application/json`

object

idintegerrequired

Example: 7365

nameobject (TranslationField) required

Translatable catalog field; has the same structure in both response and request. When creating, each network language not present in translations remains empty and is queued for AI translation. When updating, only languages from translations are saved: a language not present in the object retains its previous value if the original has not changed; an empty value clears the translation and queues it for AI translation. Changing the original clears translations that were not updated—these no longer match the original; a translation submitted with a different value is saved as a manual edit. This clearing occurs only while automatic translation is enabled for the network. Values in unpublished languages are rejected; values in languages outside the network's language set are ignored.

defaultstring

Код исходного языка сети; в запросе должен совпадать с настройкой сети

Example: ru

translationsobjectrequired

Value by language code; if no translation — no key

Dictionary values

string

text_colorstringrequired

Example: B77C7C

background_colorstringrequired

Example: 777777

Responses

object

statusstringrequired

Values:successerror

Example: success

dataobject

curl -X POST 'https://foodsoul.pro/api/crm/v2/labels.update' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: en' \
  -H 'role: partner' \
  -H 'Content-Type: application/json' \
  -d '{"id":7365,"name":{"default":"ru","translations":{"ru":"Пицца","en":"Pizza"}},"text_color":"B77C7C","background_color":"777777"}'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.pro/api/crm/v2/labels.update', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'en',
        'role' => 'partner',
    ],
    'json' => [
        'id' => 7365,
        'name' => [
            'default' => 'ru',
            'translations' => [
                'ru' => 'Пицца',
                'en' => 'Pizza',
            ],
        ],
        'text_color' => 'B77C7C',
        'background_color' => '777777',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.pro/api/crm/v2/labels.update", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "id": 7365,
        "name": {
            "default": "ru",
            "translations": {
                "ru": "Пицца",
                "en": "Pizza"
            }
        },
        "text_color": "B77C7C",
        "background_color": "777777"
    }),
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.pro/api/crm/v2/labels.update",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner",
    },
    json={
        "id": 7365,
        "name": {
            "default": "ru",
            "translations": {
                "ru": "Пицца",
                "en": "Pizza",
            },
        },
        "text_color": "B77C7C",
        "background_color": "777777",
    },
)
data = response.json()

Response 200

{
  "status": "success",
  "data": {}
}

Requests are sent to foodsoul.pro — the host of this portal; you cannot choose another one.

Update label

Authorization

Query parameters

Request body application/json

Responses

Request body `application/json`