[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ffolders\u002Ffields":3,"docs-tabs-entities\u002Ffolders\u002Ffields":6},{"content":4,"lastmod":5},"## Поля папки\n\n`GET \u002Fv1\u002Ffolders\u002Ffields`\n\nВозвращает схему доступных полей сущности: типы данных и признак доступности для записи.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log('Полей:', Object.keys(data.fields).length)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ffolders\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Битрикс24 | Тип | RO | Описание |\n|------|----------|-----|:--:|---------|\n| `id` | `ID` | number | да | Идентификатор папки |\n| `name` | `NAME` | string | | Имя папки. Обязательно при создании |\n| `parentId` | `PARENT_ID` | number | | ID родительской папки. Доступно только при создании, изменить нельзя. Список: `GET \u002Fv1\u002Ffolders`, корневая папка: `GET \u002Fv1\u002Fstorages` |\n| `storageId` | `STORAGE_ID` | number | да | ID хранилища. Список: `GET \u002Fv1\u002Fstorages` |\n| `code` | `CODE` | string | да | Символьный код. При создании и переименовании не сохраняется |\n| `type` | `TYPE` | string | да | Тип объекта: `\"folder\"` или `\"file\"` |\n| `realObjectId` | `REAL_OBJECT_ID` | number | да | Внутренний ID объекта |\n| `detailUrl` | `DETAIL_URL` | string | да | Ссылка на папку в интерфейсе Битрикс24 |\n| `deletedType` | `DELETED_TYPE` | number | да | Статус удаления: `0` — не удалена, `3` — в корзине, `4` — удалена вместе с родительской папкой |\n| `createdBy` | `CREATED_BY` | number | да | ID пользователя-создателя. Поиск: `GET \u002Fv1\u002Fusers` |\n| `updatedBy` | `UPDATED_BY` | number | да | ID автора последнего изменения. Поиск: `GET \u002Fv1\u002Fusers` |\n| `deletedBy` | `DELETED_BY` | number | да | ID пользователя, удалившего папку. Поиск: `GET \u002Fv1\u002Fusers` |\n| `createdAt` | `CREATE_TIME` | datetime | да | Дата и время создания (ISO 8601 UTC) |\n| `updatedAt` | `UPDATE_TIME` | datetime | да | Дата и время последнего изменения |\n| `deletedAt` | `DELETE_TIME` | datetime | да | Дата и время удаления. `null` — папка не удалена |\n\nПоле `name` доступно при создании и переименовании, `parentId` — только при создании. Через `PATCH \u002Fv1\u002Ffolders\u002F:id` обновляется только поле `name`.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"id\": { \"type\": \"number\", \"readonly\": true },\n      \"name\": { \"type\": \"string\", \"readonly\": false },\n      \"parentId\": { \"type\": \"number\", \"readonly\": false, \"createOnly\": true },\n      \"storageId\": { \"type\": \"number\", \"readonly\": true },\n      \"code\": { \"type\": \"string\", \"readonly\": true },\n      \"type\": { \"type\": \"string\", \"readonly\": true },\n      \"realObjectId\": { \"type\": \"number\", \"readonly\": true },\n      \"detailUrl\": { \"type\": \"string\", \"readonly\": true },\n      \"deletedType\": { \"type\": \"number\", \"readonly\": true },\n      \"createdBy\": { \"type\": \"number\", \"readonly\": true },\n      \"updatedBy\": { \"type\": \"number\", \"readonly\": true },\n      \"deletedBy\": { \"type\": \"number\", \"readonly\": true },\n      \"createdAt\": { \"type\": \"datetime\", \"readonly\": true },\n      \"updatedAt\": { \"type\": \"datetime\", \"readonly\": true },\n      \"deletedAt\": { \"type\": \"datetime\", \"readonly\": true }\n    },\n    \"relations\": {\n      \"storage\": { \"type\": \"one\", \"entity\": \"storages\", \"includable\": true }\n    }\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `disk`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'disk' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `disk` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов портала |\n| 401 | `INVALID_API_KEY` | Неверный или просроченный API-ключ |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список содержимого папки](\u002Fdocs\u002Fentities\u002Ffolders\u002Flist)\n- [Создать папку](\u002Fdocs\u002Fentities\u002Ffolders\u002Fcreate)\n- [Папки](\u002Fdocs\u002Fentities\u002Ffolders)\n- [Файлы](\u002Fdocs\u002Fentities\u002Ffiles)\n- [Синтаксис фильтрации](\u002Fdocs\u002Ffiltering)\n","2026-07-02",{}]