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

Задать источники папки «Все»

Метод в процессе раскатки — выходит в обновлении im 26.1300.0. Доступен не на всех порталах Битрикс24. Если на вашем портале метод ещё не доступен, API вернёт 422 METHOD_NOT_YET_AVAILABLE — это не ошибка интеграции, а признак того, что обновление пока не приехало на портал.

PUT /v1/chats/folders/:folderId/sources

Задаёт полный набор включённых источников папки «Все». Работает только с этой папкой. Что такое источники, их текущий набор и коды — GET /v1/chats/folders/:folderId/sources.

Параметры

Параметр	Тип	Обяз.	Описание
`folderId` (path)	number	да	ID папки «Все» — поле `id` папки с `type: "system"` и `code: "all"` из `GET /v1/chats/folders`

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`sourceCodes`	string[]	да	Коды источников, которые должны быть включены, — значения `data.sources[].code` из `GET /v1/chats/folders/:folderId/sources`. Элемент — непустая строка до 64 символов. `[]` выключает все источники, которые можно выключить

Параметров запроса нет. Любой параметр запроса или другое поле тела отклоняется с 400 INVALID_PARAMS.

Примеры

curl — личный ключ

Terminal

# Оставить включёнными задачи и коллабы в папке «Все» (ID 7)
curl -X PUT "https://vibecode.bitrix24.tech/v1/chats/folders/7/sources" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceCodes": ["tasksTask", "collab"]}'

curl — OAuth-приложение

Terminal

# Оставить включёнными задачи и коллабы в папке «Все» (ID 7)
curl -X PUT "https://vibecode.bitrix24.tech/v1/chats/folders/7/sources" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sourceCodes": ["tasksTask", "collab"]}'

JavaScript — личный ключ

javascript

const base = 'https://vibecode.bitrix24.tech/v1/chats/folders/7/sources'
const headers = { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }

const { data } = await fetch(base, { headers }).then((r) => r.json())

// Выключить коллабы, остальное оставить как есть
const sourceCodes = data.sources
  .filter((s) => s.togglable && s.enabled && s.code !== 'collab')
  .map((s) => s.code)

const saved = await fetch(base, {
  method: 'PUT',
  headers,
  body: JSON.stringify({ sourceCodes }),
}).then((r) => r.json())

console.log('Включены:', saved.data.sourceFolders)

JavaScript — OAuth-приложение

javascript

const base = 'https://vibecode.bitrix24.tech/v1/chats/folders/7/sources'
const headers = {
  'X-Api-Key': 'YOUR_APP_KEY',
  'Authorization': 'Bearer USER_SESSION_TOKEN',
  'Content-Type': 'application/json',
}

const { data } = await fetch(base, { headers }).then((r) => r.json())

// Выключить коллабы, остальное оставить как есть
const sourceCodes = data.sources
  .filter((s) => s.togglable && s.enabled && s.code !== 'collab')
  .map((s) => s.code)

const saved = await fetch(base, {
  method: 'PUT',
  headers,
  body: JSON.stringify({ sourceCodes }),
}).then((r) => r.json())

console.log('Включены:', saved.data.sourceFolders)

Поля ответа

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data.sourceFolders`	string[]	Коды источников, включённых после записи, — с учётом обязательного

Пример ответа

JSON

{
  "success": true,
  "data": {
    "sourceFolders": ["default", "tasksTask", "collab"]
  }
}

Пример ответа при ошибке

400 — не передан sourceCodes: