Skip to main content
Cycles is a custom time period in which a team works to complete items on their backlog. At the end of the sprint, the team will usually have finished building and implementing a new version of their project or product. 
POST   /api/v1/workspaces/:workspace-slug/projects/:project_id/cycles/
GET    /api/v1/workspaces/:workspace-slug/projects/:project_id/cycles/
GET    /api/v1/workspaces/:workspace-slug/projects/:project_id/cycles/:cycle_id/
PATCH  /api/v1/workspaces/:workspace-slug/projects/:project_id/cycles/:cycle_id/
DELETE /api/v1/workspaces/:workspace-slug/projects/:project_id/cycles/:cycle_id/
POST   /api/v1/workspaces/:workspace-slug/projects/:project_id/cycles/:cycle_id/transfer-issues/
To transfer issues of one cycle to another, the payload should be sent in the below format 
{
	"new_cycle_id": "2380ce13-1cc4-4f67-9f57-a2b7686886d7"
}

​
Cycle Object

Attributes
  • name string (required) Name of the cycle
  • description string Description of the cycle
  • start_date date Start date of the cycle
  • end_date date End date of the cycle
  • created_at timestamp The timestamp of the time when the project was created
  • updated_at timestamp The timestamp of the time when the project was last updated
  • view_props It store the filters and the display properties selected by the user to visualize the issues in the module
  • sort_order It gives the position of the module at which it should be displayed
  • created_by , updated_by uuid These values are auto saved and represent the id of the user that created or the updated the
  • Project uuid It contains projects uuid which is automatically saved.
  • Workspace uuid It contains workspace uuid which is automatically saved
  • owned_by uuid 
{
	"id": "50ebc791-65e4-4b4d-a164-3b4e529e55a5",
	"created_at": "2023-11-19T12:18:14.900078Z",
	"updated_at": "2023-11-19T12:18:14.900088Z",
	"name": "cycle testing",
	"description": "",
	"start_date": null,
	"end_date": null,
	"view_props": {},
	"sort_order": 35535.0,
	"created_by": "0649cb9d-05c8-4ef4-8e8b-d108ccddd42c",
	"updated_by": "0649cb9d-05c8-4ef4-8e8b-d108ccddd42c",
	"project": "6436c4ae-fba7-45dc-ad4a-5440e17cb1b2",
	"workspace": "c467e125-59e3-44ec-b5ee-f9c1e138c611",
	"owned_by": "0649cb9d-05c8-4ef4-8e8b-d108ccddd42c"
}
⌘I