For AI agents: markdown of this page — /docs-content-en/chats/management/folder-sources-update.md documentation index — /llms.txt

Set the sources of the "All" folder

The method ships in the im 26.1300.0 update and is not yet available on all Bitrix24 accounts. If the update has not reached your Bitrix24 account yet, the API returns 422 METHOD_NOT_YET_AVAILABLE — this means the method has not been released on the account yet, not that the integration is broken.

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

Sets the full set of enabled sources of the "All" folder. Works only with this folder. What sources are, their current set and their codes — GET /v1/chats/folders/:folderId/sources.

Parameters

Parameter	Type	Required	Description
`folderId` (path)	number	yes	ID of the "All" folder — the `id` of the folder with `type: "system"` and `code: "all"` from `GET /v1/chats/folders`

Request fields (body)

Field	Type	Required	Description
`sourceCodes`	string[]	yes	Codes of the sources that must be enabled — the `data.sources[].code` values from `GET /v1/chats/folders/:folderId/sources`. Each element is a non-empty string of up to 64 characters. `[]` switches off every source that can be switched off

There are no query parameters. Any query parameter or other body field is rejected with 400 INVALID_PARAMS.

Examples

curl — personal key

Terminal

# Keep tasks and collabs enabled in the "All" folder (ID 7)
curl -X PUT "https://vibecode.bitrix24.com/v1/chats/folders/7/sources" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceCodes": ["tasksTask", "collab"]}'

curl — OAuth application

Terminal

# Keep tasks and collabs enabled in the "All" folder (ID 7)
curl -X PUT "https://vibecode.bitrix24.com/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 — personal key

javascript

const base = 'https://vibecode.bitrix24.com/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())

// Switch collabs off, keep the rest as is
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('Enabled:', saved.data.sourceFolders)

JavaScript — OAuth application

javascript

const base = 'https://vibecode.bitrix24.com/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())

// Switch collabs off, keep the rest as is
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('Enabled:', saved.data.sourceFolders)

Response fields

Field	Type	Description
`success`	boolean	Always `true` on success
`data.sourceFolders`	string[]	Codes of the sources enabled after the write — including the mandatory one

Response example

JSON

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

Error response example

400 — sourceCodes is missing: