landing.site.updateFolder
Изменить папку в сайте
Описание
Метод landing.site.updateFolder обновляет параметры папки сайта.
Параметры
scope
string
необязательный
Внутренний скоуп лендингов. Он не связан с REST-скоупом landing в названии метода.
Значение scope должно соответствовать типу сайта (подробное описание)
siteId
integer
обязательный
Идентификатор сайта, к которому относится папка.
Идентификатор сайта можно получить методом landing.site.getList
folderId
integer
обязательный
Идентификатор папки, которую нужно обновить.
Идентификатор папки можно получить методом landing.site.getFolders
fields
object
обязательный
Набор полей для обновления папки (подробное описание)
Параметр fields
TITLE
string
необязательный
Название папки
CODE
string
необязательный
Символьный код папки для URL. Код не может содержать символ /.
Если параметр не передан, используется текущее значение CODE папки
PARENT_ID
integer
необязательный
Идентификатор родительской папки.
Если значение 0, null, пустое или параметр не передан, папка переносится в корень сайта
INDEX_ID
integer
необязательный
Идентификатор индексной страницы папки
ACTIVE
string
необязательный
Флаг активности папки Y/N
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"siteId": 1817,
"folderId": 736,
"fields": {
"TITLE": "Каталог услуг",
"CODE": "services-catalog",
"PARENT_ID": 0,
"INDEX_ID": 987,
"ACTIVE": "Y"
}
}' \
"https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.site.updateFolder.json"
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"siteId": 1817,
"folderId": 736,
"fields": {
"TITLE": "Каталог услуг",
"CODE": "services-catalog",
"PARENT_ID": 0,
"INDEX_ID": 987,
"ACTIVE": "Y"
},
"auth": "**put_access_token_here**"
}' \
"https://**put.your-domain-here**/rest/landing.site.updateFolder.json"
// 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: 'landing.site.updateFolder',
params: {
siteId: 1817,
folderId: 736,
fields: {
TITLE: 'Services Catalog',
CODE: 'services-catalog',
PARENT_ID: 0,
INDEX_ID: 987,
ACTIVE: 'Y',
},
},
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('Folder updated successfully:', 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 updateFolder() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'landing.site.updateFolder',
params: {
siteId: 1817,
folderId: 736,
fields: {
TITLE: 'Services Catalog',
CODE: 'services-catalog',
PARENT_ID: 0,
INDEX_ID: 987,
ACTIVE: 'Y',
},
},
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('Folder updated successfully:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateFolder)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.landing.site.update_folder(
site_id=1817,
folder_id=736,
fields={
"TITLE": "Services Catalog",
"CODE": "services-catalog",
"PARENT_ID": 0,
"INDEX_ID": 987,
"ACTIVE": "Y",
},
).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(
'landing.site.updateFolder',
[
'siteId' => 1817,
'folderId' => 736,
'fields' => [
'TITLE' => 'Каталог услуг',
'CODE' => 'services-catalog',
'PARENT_ID' => 0,
'INDEX_ID' => 987,
'ACTIVE' => 'Y',
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . var_export($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating folder: ' . $e->getMessage();
}
BX24.callMethod(
'landing.site.updateFolder',
{
siteId: 1817,
folderId: 736,
fields: {
TITLE: 'Каталог услуг',
CODE: 'services-catalog',
PARENT_ID: 0,
INDEX_ID: 987,
ACTIVE: 'Y'
}
},
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'landing.site.updateFolder',
[
'siteId' => 1817,
'folderId' => 736,
'fields' => [
'TITLE' => 'Каталог услуг',
'CODE' => 'services-catalog',
'PARENT_ID' => 0,
'INDEX_ID' => 987,
'ACTIVE' => 'Y',
],
]
);
if (isset($result['error']))
{
echo 'Ошибка: ' . $result['error_description'];
}
else
{
echo '<pre>';
print_r($result['result']);
echo '</pre>';
}
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "landing.site.updateFolder", b24.Params{
"siteId": 1817,
"folderId": 736,
"fields": b24.Params{
"TITLE": "Каталог услуг",
"CODE": "services-catalog",
"PARENT_ID": 0,
"INDEX_ID": 987,
"ACTIVE": "Y",
},
})
if err != nil {
return fmt.Errorf("landing.site.updateFolder: %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": 1773291230,
"finish": 1773291230.313858,
"duration": 0.3138580322265625,
"processing": 0,
"date_start": "2026-03-12T07:53:50+03:00",
"date_finish": "2026-03-12T07:53:50+03:00",
"operating_reset_at": 1773291830,
"operating": 0
}
}
Возвращаемые данные
result
boolean
Возвращает true, если папка успешно обновлена
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "ACCESS_DENIED",
"error_description": "Сайт не найден или доступ к нему запрещен."
}
| Код | Описание | Значение |
|---|---|---|
MISSING_PARAMS |
Не передан обязательный параметр siteId, folderId или fields |
|
ACCESS_DENIED |
Сайт не найден или доступ к нему запрещен | |
FOLDER_IS_NOT_UNIQUE |
С таким именем уже определена папка | |
SLASH_IS_NOT_ALLOWED |
Слеш запрещен в адресе папки |

