b24_scrum_sprint_list
Read-onlyIdempotent
Retrieve Scrum sprints for a group, filtered by status (active, planned, completed) with pagination support. Returns sprint IDs, names, dates, and status to manage sprint planning.
Instructions
List sprints of a Scrum group (tasks.api.scrum.sprint.list).
Returns a pagination envelope of sprint objects (id, name, dateStart, dateEnd, status, ...). Use the active sprint's id with b24_scrum_kanban_stages to get the real board columns.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start | No | Pagination offset (page size is 50). Use 'next' from a prior response. | |
| status | No | Sprint status filter: 'active' (default), 'planned', 'completed', or null for all. Defaulting to 'active' avoids the pagination trap where the current sprint is never reached. | active |
| group_id | Yes | Scrum group/project id (GROUP_ID). | |
| fetch_all | No | Auto-paginate and return all matching records (capped by BITRIX_MAX_PAGES, default 40 pages = 2000 records). Use a filter to keep this bounded. | |
| webhook_url | No | Override the default incoming webhook for this call (https://<portal>/rest/<user_id>/<token>/). If omitted, uses personal_webhook, then the X-B24-Webhook HTTP header, then the BITRIX_WEBHOOK_URL env default. | |
| personal_webhook | No | Act as a specific user (their personal incoming webhook). Takes precedence over webhook_url. Required to write to the portal under that user's permissions. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |