метод REST scope: sonet

sonet_group.update

Изменить группу или проект

Кто может выполнять: администратор или владелец группы или проекта

Описание

Метод sonet_group.update изменяет параметры рабочей группы или проекта.

Параметры

GROUP_ID integer обязательный

Идентификатор группы или проекта.

Идентификатор можно получить методом sonet_group.get

NAME string необязательный

Новое название

DESCRIPTION string необязательный

Новое описание

VISIBLE string необязательный

Видимость группы в списке.

Возможные значения:
- Y — группа видна в общем списке
- N — группа скрыта из общего списка

Для экстранет-пользователя значение принудительно устанавливается в N

OPENED string необязательный

Открыта ли группа для свободного вступления.

Возможные значения:
- Y — пользователь может вступить в группу без подтверждения
- N — вступление по приглашению или запросу

Для экстранет-пользователя значение принудительно устанавливается в N

CLOSED string необязательный

Архивная ли группа.

Возможные значения:
- Y — группа в архиве
- N — активная группа

KEYWORDS string необязательный

Ключевые слова через запятую

INITIATE_PERMS string необязательный

Кто может приглашать участников.

Возможные значения:
- A — только владелец группы
- E — владелец и модераторы
- K — все участники

PROJECT_DATE_START datetime необязательный

Дата начала проекта в формате ISO-8601

PROJECT_DATE_FINISH datetime необязательный

Дата окончания проекта в формате ISO-8601

OWNER_ID integer необязательный

Новый владелец группы.

Идентификатор пользователя можно получить методом user.get

IMAGE file необязательный

Новый аватар группы в формате Base64

IMAGE_FILE_ID integer необязательный

Идентификатор файла из Диска для установки аватара.

Идентификатор файла можно получить методами disk.storage.getchildren и disk.folder.getchildren.

Чтобы удалить аватар передавайте IMAGE_FILE_ID: 0. Аватар удалится, даже если одновременно передать IMAGE, он не будет использован

SITE_ID array необязательный

Список сайтов, к которым привязана группа

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"GROUP_ID":77,"NAME":"Новый заголовок проекта"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sonet_group.update

Ответ

HTTP-статус: 200

{
    "result": 77,
    "time": {
        "start": 1773923568,
        "finish": 1773923568.505599,
        "duration": 0.5055990219116211,
        "processing": 0,
        "date_start": "2026-03-19T15:32:48+03:00",
        "date_finish": "2026-03-19T15:32:48+03:00",
        "operating_reset_at": 1773924168,
        "operating": 0.3419780731201172
    }
}

Возвращаемые данные

result integer

Идентификатор обновленной группы или проекта

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "",
    "error_description": "Wrong group ID"
}
Код Описание Значение
Wrong group ID Передан некорректный GROUP_ID
User has no permissions to update group Недостаточно прав для изменения группы или проекта
Cannot update group Не удалось обновить группу или проект
ERROR_IMAGE_ID Изображение не корректно: Неверный тип файла Передан некорректный IMAGE

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.