Skip to main content
Cycle (sprint, iteration, version, release) — a time-boxed grouping of items. Cycles attach to a board and accumulate items via cycleId on each item. Used for planning views, burn-down reports, and per-sprint filtering.

​
Sample JSON

Copy, edit, paste. Server-set fields (id, created, tenantId, …) are omitted from the example — they’re populated by the server on response. 
{
  "name": "Sprint 42",
  "description": "Q2 2026 — login & timeout fixes.",
  "boardId": "board_01HBOARD_FEN",
  "order": 42,
  "startDate": "2026-04-15T00:00:00Z",
  "finishDate": "2026-04-29T23:59:59Z",
  "budgetHours": 80,
  "locked": false,
  "closed": false
}

​
What Ekso fills in

These fields are managed by the server. You don’t pass them on writes — they appear on the response.
  • items — Maintained automatically — each item carrying cycleId == <this cycle's id> shows up here.

​
Fields

FieldTypeRequiredNotes
entitystring • nullableServer-setSet by the server. Read-only on writes.
namestringRequiredDisplay name of the cycle. Sprint-style names (Sprint 42) are common; release-style names (v2.4.0) work too.
descriptionstringRequiredBrief summary of what’s in this cycle.
boardIdstringOptionalId of the parent board. A cycle belongs to exactly one board.
orderintegerOptionalOrdering hint for cycle lists. Typically the sprint number.
parentstringOptionalId of a parent cycle, when cycles nest (rare; some teams use this for release-of-sprints hierarchy).
startDatestring • nullableOptionalCycle start. Optional — leave null for ad-hoc / unscheduled cycles.
finishDatestring • nullableOptionalCycle end.
budgetHoursintegerOptionalTotal time-budget for items in this cycle. Used by burn-down reports.
lockedbooleanOptionalWhen true, items can’t be added or removed from this cycle.
closedbooleanOptionalWhen true, the cycle is past — won’t appear in active-sprint pickers.
itemsarray<string>Server-setArray of item ids assigned to the cycle. Maintained automatically as items’ cycleId changes.
tenantIdstringServer-setSet by the server. Read-only on writes.
idstringServer-setSet by the server. Read-only on writes.
createdstring (date-time)Server-setSet by the server. Read-only on writes.
createdBystringServer-setSet by the server. Read-only on writes.
updatedstring (date-time)Server-setSet by the server. Read-only on writes.
updatedBystringServer-setSet by the server. Read-only on writes.
deletedbooleanServer-setSet by the server. Read-only on writes.

​
Used by

​
Request body

  • POST /api/board/{boardId}/cycle
  • PUT /api/board/{boardId}/cycle/{cycleId}

​
Response body

  • GET /api/board/cycle
  • GET /api/board/{boardId}/cycle/{cycleId}
  • GET /api/board/{boardId}/cycle

​
CLI

ekso cycle — see the command branches page for available verbs. Body for create / update verbs typically passed via --data @file.json matching the sample JSON above.