list_cycles
Retrieve active or archived cycles for a Plane project. Filter by status and paginate results for efficient management.
Instructions
List cycles in a project. Active (non-archived) cycles by default.
Args: project_id: UUID of the project archived: Set True to list archived cycles instead of active ones. status: Filter active cycles by status - "current" (running now), "upcoming" (starts later), "completed" (ended), "draft" (no dates), or "incomplete" (not yet finished). Ignored when archived is True. cursor: Pagination cursor from a previous response's next_cursor (form "{per_page}:{page}:{offset}"). Omit for the first page. per_page: Number of results per page (1-1000, default and max 1000). order_by: Field to order results by. Prefix with '-' for descending.
Returns: Paginated envelope: results (lite cycles) + total_count, next_cursor, next_page_results.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | ||
| status | No | ||
| archived | No | ||
| order_by | No | ||
| per_page | No | ||
| project_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |