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

Прочитать право сортировать канбан

GET /v1/tasks/stages/:entityId/can-move

Сообщает, может ли пользователь ключа переносить задачи между стадиями канбана рабочей группы. Помогает решить, показывать ли перетаскивание карточек до вызова переноса.

Параметры

Параметр Тип Обяз. Описание
entityId (path) number да ID рабочей группы или 0 — «Мой план» владельца ключа. Список групп: GET /v1/workgroups

Query-параметров у метода нет: любой из них отклоняется с 400 INVALID_PARAMS.

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/tasks/stages/155/can-move" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/tasks/stages/155/can-move" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/stages/155/can-move', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { success, data } = await res.json()
console.log(data.canMove)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/stages/155/can-move', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()
console.log(data.canMove)

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Результат проверки
data.canMove boolean true — пользователь ключа может переносить задачи в канбане, false — не может

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

JSON 
{
  "success": true,
  "data": {
    "canMove": true
  }
}

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

400 — entityId не целое неотрицательное число или передан query-параметр:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "entityId must be non-negative; query parameters are not supported"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS entityId не целое неотрицательное число или передан query-параметр
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 TOKEN_MISSING У ключа нет действующего токена Битрикс24
403 SCOPE_DENIED У ключа нет скоупа task или tasks
422 BITRIX_ERROR Битрикс24 отклонил запрос, текст в message
502 BITRIX_ERROR Битрикс24 вернул ответ неожиданной структуры: Invalid can-move response

Полный список общих ошибок API — Ошибки.

Известные особенности

  • Право на всю доску, а не на задачу. Ответ говорит, можно ли переносить задачи в канбане группы вообще. Права на конкретную задачу он не проверяет: перенос чужой задачи всё равно может получить отказ.
  • Для «Моего плана» ответ всегда true. При entityId: 0 метод не обращается к Битрикс24.
  • Несуществующая группа не даёт ошибку. Для группы, которой нет на портале, приходит 200 и canMove: false.
  • Ключ только для чтения подходит. Метод ничего не меняет.

Смотрите также