Iterations
list_iterationsRead-onlyIdempotent
Retrieve iterations (sprints) for a GitLab group with cadence information. Supports filtering by state and pagination for complete results.
Instructions
List iterations (sprints) for a group with cadence info. Requires GitLab Premium/Ultimate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Pagination cursor. To fetch the next page, pass the previous response pageInfo.endCursor here and repeat until pageInfo.hasNextPage is false. Paginating this way is the reliable path to complete results and accurate totals. | |
| first | No | Number of iterations to retrieve | |
| state | No | Filter by state: upcoming, current, opened, closed (omit for all) | |
| fetchAll | No | Fetch multiple pages in one call, up to "first" items total (max 100) — NOT exhaustive. For complete results or accurate counts, leave this false and paginate via after (pageInfo.endCursor). | |
| groupPath | Yes | Full path of the group (e.g., "my-group" or "parent/child-group") | |
| userCredentials | No | Your GitLab credentials (optional — falls back to the configured env token if not provided) |