Scrum: эпики, спринты, размещение задач и этапы канбана

Управление скрамом в проектах Битрикс24: чтение списка и текущего спринта, создание и переименование эпиков, привязка задач к эпикам, размещение в бэклоге, story points, колонки доски спринта. Работает поверх обычных Задач — сначала задача создаётся через POST /v1/tasks, затем размещается в скраме.

Скоуп: task | Базовый URL: https://vibecode.bitrix24.tech/v1 | Авторизация: X-Api-Key

Разделы документации

• Бэклоги скрама — создание, обновление и удаление бэклогов
• Эпики скрама — создание, чтение, переименование и перекраска эпиков
• Размещение задач в скраме — чтение и изменение скрам-строки задачи: бэклог или спринт, эпик, story points
• Спринты — список, текущий спринт и чтение спринта по ID
• Этапы Scrum-канбана — колонки доски спринта
• Definition of Done — настройки и сохранение списков DoD
• Метрики спринта — данные Битрикс24 для графика и скорости команды

Быстрый старт

1. Создать эпик

curl -X POST "https://vibecode.bitrix24.tech/v1/scrum/epics" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Папки в чатах", "groupId": 7 }'

2. Привязать задачу к эпику

Задача уже создана через POST /v1/tasks и находится в скрам-проекте groupId. Привязка автоматически помещает её в бэклог проекта:

curl -X PATCH "https://vibecode.bitrix24.tech/v1/scrum/tasks/59" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "epicId": 87 }'

Полный пример: зеркалирование внешнего трекера

Создать эпик, завести задачу в скрам-проекте, привязать её к эпику и проверить размещение. Бэклог определяется автоматически.

const VIBE_KEY = process.env.VIBE_KEY
const BASE = 'https://vibecode.bitrix24.tech/v1'
const GROUP_ID = 7 // скрам-проект, список: GET /v1/workgroups

// ── 1. Создать эпик ─────────────────────────────────────────────
const epicRes = await fetch(`${BASE}/scrum/epics`, {
  method: 'POST',
  headers: { 'X-Api-Key': VIBE_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Папки в чатах', groupId: GROUP_ID })
})
const { data: epic } = await epicRes.json()
console.log(`Эпик создан, ID: ${epic.id}`)

// ── 2. Создать задачу в том же скрам-проекте ────────────────────
const taskRes = await fetch(`${BASE}/tasks`, {
  method: 'POST',
  headers: { 'X-Api-Key': VIBE_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Сверстать список папок', groupId: GROUP_ID, responsibleId: 1 })
})
const { data: task } = await taskRes.json()
console.log(`Задача создана, ID: ${task.id}`)

// ── 3. Привязать задачу к эпику ─────────────────────────────────
//     entityId опущен → задача автоматически попадает в бэклог проекта
await fetch(`${BASE}/scrum/tasks/${task.id}`, {
  method: 'PATCH',
  headers: { 'X-Api-Key': VIBE_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ epicId: epic.id, storyPoints: '3' })
})

// ── 4. Проверить фактическое размещение ─────────────────────────
const placeRes = await fetch(`${BASE}/scrum/tasks/${task.id}`, {
  headers: { 'X-Api-Key': VIBE_KEY }
})
const { data: placement } = await placeRes.json()
console.log('Размещение:', placement)

Справочник эндпоинтов

| POST | /v1/scrum/backlogs | tasks.api.scrum.backlog.add | Создать бэклог | | PATCH | /v1/scrum/backlogs/:id | tasks.api.scrum.backlog.update | Обновить бэклог | | DELETE | /v1/scrum/backlogs/:id | tasks.api.scrum.backlog.delete | Удалить бэклог | | DELETE | /v1/scrum/epics/:id | tasks.api.scrum.epic.delete | Удалить эпик | | POST | /v1/scrum/sprints | tasks.api.scrum.sprint.add | Создать спринт | | PATCH | /v1/scrum/sprints/:id | tasks.api.scrum.sprint.update | Обновить спринт | | DELETE | /v1/scrum/sprints/:id | tasks.api.scrum.sprint.delete | Удалить спринт | | POST | /v1/scrum/sprints/:id/start | tasks.api.scrum.sprint.start | Начать спринт | | POST | /v1/scrum/groups/:groupId/sprints/active/complete | tasks.api.scrum.sprint.complete | Завершить активный спринт группы | | DELETE | /v1/scrum/stages/:stageId | tasks.api.scrum.kanban.deleteStage | Удалить этап | | POST | /v1/scrum/sprints/:sprintId/kanban/tasks/:taskId | tasks.api.scrum.kanban.addTask | Добавить задачу на доску | | DELETE | /v1/scrum/sprints/:sprintId/kanban/tasks/:taskId | tasks.api.scrum.kanban.deleteTask | Удалить задачу с доски |

Коды ошибок

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

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

• Задачи
• Чат задачи
• Рабочие группы
• Лимиты и оптимизация