Для AI-агентов: markdown этой страницы — /docs-content/entities/sites/permissions.md индекс документации — /llms.txt

Права сайта

PUT /v1/sites/:id/permissions

DELETE /v1/sites/:id/permissions

ВНИМАНИЕ: полностью заменяет права сайта. Непустой rights обязателен; коды доступа — любые непустые строки (U1373, G42, DR42, AU). read добавляется автоматически, denied затирает остальные операции. Пустой массив операций у одного кода допускается: Б24 добавит read. Назначенные права нечем перечитать: my-permissions показывает только текущего пользователя. Для явной очистки всех прав используйте DELETE /v1/sites/:id/permissions без тела. Очистка возвращает доступ по умолчанию. Требуется администратор и тариф с расширенными правами: IS_NOT_ADMIN / FEATURE_NOT_AVAIL дают 403. id=0 запрещён.

Параметры

Parameter	Type	Required	Description
id	integer	yes	Positive safe integer site ID
scope	string	no	KNOWLEDGE / GROUP / MAINPAGE; omit for ordinary sites
rights	object	PUT only	Non-empty access-code dictionary of operation arrays

Нужен скоуп ключа landing. Без scope сайт базы знаний или группы может быть невидим.

curl

Terminal

curl -X PUT "https://vibecode.bitrix24.tech/v1/sites/42/permissions" -H "X-Api-Key: YOUR_API_KEY" -H 'Content-Type: application/json' -d '{"rights":{"U42":["edit"]}}'

JavaScript

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/sites/42/permissions", {
  method: "PUT",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ rights: { U42: ["edit"] } }),
});
const data = await response.json();

Ответ

JSON

{
  "success": true,
  "data": {
    "updated": true
  }
}

Ошибки

400 INVALID_PARAMS / INVALID_SCOPE; 401 TOKEN_MISSING; 403 SCOPE_DENIED / BITRIX_ACCESS_DENIED; 404 ENTITY_NOT_FOUND; 409 LANDING_MODULE_NOT_ENABLED; 422 BITRIX_ERROR; 429 rate limits; 502 / 503 upstream or transport refusal. Записывающие операции с READONLY-ключом дают 403 WRITE_BLOCKED_READONLY_KEY.

Bitrix24: landing.site.setRights.

Сайты