Чтение таска

Endpoint

GET /bot/tasks/{task_id}

Возвращает задачу, если bot-пользователь имеет доступ к форме этой задачи.

Что возвращается

Основные поля:

• task_id
• form_id
• title
• author_id
• responsible_id
• responsible_ids
• created_at
• last_activity
• is_finished
• status
• due_date_at
• step_id
• step_assignments
• items

Как возвращаются step_assignments

step_assignments содержит все назначения таска, включая назначения с предыдущих этапов маршрута.

Для каждого assignment возвращаются:

• assignment_id - ID назначения, который принимает POST /bot/tasks/{task_id}/step-return
• step_id - ID этапа маршрута этого назначения
• assignee_id - ID назначенного пользователя или null для группового назначения
• group_assignee_ids - ID пользователей группового назначения
• group_name - название группы или null
• step_role_id - ID роли назначения
• is_confirmed - статус подтверждения назначения

Чтобы вернуть таск на предыдущий этап, выберите assignment этапа, который находится раньше текущего step_id таска, и передайте его assignment_id в endpoint возврата таска на этап.

Как возвращаются items

items - это массив верхнеуровневых task items.

Для каждого item возвращаются:

• item_id
• form_field_id
• form_field_type
• name
• value
• float_value
• date_value
• linked_task_id

Как возвращаются таблицы

Если item является таблицей, у него дополнительно есть rows.

Каждая строка содержит:

• row_id
• position
• items

Внутри rows[].items используются те же поля item-ответа:

• item_id
• form_field_id
• form_field_type
• name
• value
• float_value
• date_value
• linked_task_id

Что не включается автоматически

• comments не включаются
• files не включаются

Текущий GET /bot/tasks/{task_id} сериализует сам таск, все его назначения и task_items с table rows.

Пример read task

GET /bot/tasks/5001
Authorization: Bearer <token>

{
  "success": true,
  "error_message": null,
  "data": {
    "task_id": 5001,
    "form_id": 12,
    "title": "Lead #5001 Lead from website",
    "author_id": 77,
    "responsible_id": 45,
    "responsible_ids": [45],
    "created_at": "2026-03-29T10:00:00+00:00",
    "last_activity": "2026-03-29T10:00:00+00:00",
    "is_finished": false,
    "status": "new",
    "due_date_at": null,
    "step_id": 3,
    "step_assignments": [
      {
        "assignment_id": 120,
        "step_id": 2,
        "assignee_id": 45,
        "group_assignee_ids": [],
        "group_name": null,
        "step_role_id": 1,
        "is_confirmed": true
      },
      {
        "assignment_id": 123,
        "step_id": 3,
        "assignee_id": 45,
        "group_assignee_ids": [],
        "group_name": null,
        "step_role_id": 1,
        "is_confirmed": false
      }
    ],
    "items": [
      {
        "item_id": 7001,
        "form_field_id": 101,
        "form_field_type": "TextField",
        "name": "Title",
        "value": "Lead from website",
        "float_value": null,
        "date_value": null,
        "linked_task_id": null
      },
      {
        "item_id": 7002,
        "form_field_id": 104,
        "form_field_type": "TableField",
        "name": "Products",
        "value": "",
        "float_value": null,
        "date_value": null,
        "linked_task_id": null,
        "rows": [
          {
            "row_id": 8101,
            "position": 1,
            "items": [
              {
                "item_id": 7003,
                "form_field_id": 201,
                "form_field_type": "TextField",
                "name": "Product name",
                "value": "Product A",
                "float_value": null,
                "date_value": null,
                "linked_task_id": null
              }
            ]
          }
        ]
      }
    ]
  }
}

Типовые ошибки

• 404 Task not found
• 403 Form access not found
• 429 Rate limit exceeded. Retry after {seconds} seconds