crm.status.update
Обновить элемент справочника
Описание
Метод crm.status.update обновляет параметры существующего элемента справочника.
Параметры
id
integer
обязательный
Идентификатор элемента справочника, который нужно обновить. Получить список можно методом crm.status.list
fields
object
обязательный
Массив полей для обновления. Список доступных полей описан ниже
Параметр fields
NAME
string
необязательный
Название
SORT
integer
необязательный
Сортировка
COLOR
string
необязательный
Цвет hex-код, например #39A8EF
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":123,"fields":{"NAME":"Новое название","COLOR":"#00A9F4"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.status.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":123,"fields":{"NAME":"Новое название","COLOR":"#00A9F4"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.status.update
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'crm.status.update',
params: {
id: 123,
fields: {
NAME: 'New name',
COLOR: '#00A9F4',
},
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Status updated:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function updateStatus() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'crm.status.update',
params: {
id: 123,
fields: {
NAME: 'New name',
COLOR: '#00A9F4',
},
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Status updated:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateStatus)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.crm.status.update(
bitrix_id=123,
fields={
"NAME": "Новое название",
"COLOR": "#00A9F4",
},
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'crm.status.update',
[
'id' => 123,
'fields' => [
'NAME' => 'Новое название',
'COLOR' => '#00A9F4'
]
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
echo 'Error updating status: ' . $result->error();
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating status: ' . $e->getMessage();
}
BX24.callMethod(
"crm.status.update",
{
id: 123,
fields: {
NAME: "Новое название",
COLOR: "#00A9F4"
}
},
function(result) {
if(result.error())
console.error(result.error());
else
console.dir(result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'crm.status.update',
[
'id' => 123,
'fields' => [
'NAME' => 'Новое название',
'COLOR' => '#00A9F4'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.status.update", b24.Params{
"id": 123,
"fields": b24.Params{
"NAME": "Новое название",
"COLOR": "#00A9F4",
},
})
if err != nil {
return fmt.Errorf("crm.status.update: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1752149050.805837,
"finish": 1752149050.842422,
"duration": 0.036585092544555664,
"processing": 0.009345054626464844,
"date_start": "2025-07-10T15:04:10+03:00",
"date_finish": "2025-07-10T15:04:10+03:00",
"operating_reset_at": 1752149650,
"operating": 0
}
}
Возвращаемые данные
result
boolean
Корневой элемент ответа, содержит true в случае успеха
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "Invalid identifier.",
"error_description": "Передан некорректный идентификатор."
}
| Код | Описание | Значение |
|---|---|---|
400 |
Access denied. |
Нет прав на выполнение операции |
400 |
Invalid identifier. |
Передан некорректный идентификатор |
400 |
Status is not found. |
Элемент не найден |
400 |
Error on updating status. |
Ошибка при обновлении элемента |

