Cycle

List Cycles

Retrieves a paginated list of planning cycles.

Cycles are ordered by created_at ascending (oldest first).

Response includes:

  • Cycle details (title, start_date, target_date)
  • current - Whether this is the organization's current cycle (at most one is), determined within the organization's leading rhythm
get/cycles

Request

  • Base URL: https://connect.workpath.com/api/v3
  • URL: https://connect.workpath.com/api/v3/cycles
  • Auth: HTTP bearer

Query parameters

pageinteger
Example:1

The page you want to request. First page will be returned if omitted or invalid.

Response

OK

idinteger required

Unique identifier for the cycle.

titlestring required

Display title of the cycle.

start_datestring date required

Start date of the cycle in ISO 8601 format.

target_datestring date required

Last day of the cycle.

currentboolean required

Whether this is the organization's current cycle. Accounts can plan in several rhythms (for example quarterly and yearly), and only cycles of the organization's leading rhythm are considered: the one covering today (the shortest, if several do); if none covers today, the most recently started cycle, or else the next upcoming one. At most one cycle is current.

Example response

[
  {
    "id": 9,
    "title": "Q1 2026",
    "start_date": "2026-01-01",
    "target_date": "2026-03-31",
    "current": true
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.