list_group_iterations
Read-only
List group iterations with filters for state, search, date range, and ancestor/descendant inclusion. Retrieve paginated iteration data for GitLab groups using numeric ID or URL-encoded path.
Instructions
List group iterations with filtering options. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default: 1) | |
| state | No | Return opened, upcoming, current, closed, or all iterations. | |
| search | No | Return only iterations with a title matching the provided string. | |
| group_id | Yes | Group ID or URL-encoded path | |
| per_page | No | Number of items per page (max: 100, default: 20) | |
| search_in | No | Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title]. | |
| updated_after | No | Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | |
| updated_before | No | Return only iterations updated before the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | |
| include_ancestors | No | Include iterations for group and its ancestors. Defaults to true. | |
| include_descendants | No | Include iterations for group and its descendants. Defaults to false. |