DevelopersAPI referenceTasksCycles
List cycles
Cycles across the org's teams, highest number first. Filter with team_id.
View as MarkdownAuthorization
bearer AuthorizationBearer <token>
In: header
Query Parameters
team_id?string
Restrict to one team.
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/cycles"{ "cycles": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "number": 0, "name": "string", "startsAt": "2019-08-24", "endsAt": "2019-08-24" } ]}Delete a label
Hard delete. The label disappears from issues it was attached to.
Create a cycle
number defaults to (max number in the team) + 1, which cannot collide; pinning an explicit number that is already taken is a 409, since (team_id, number) is unique. startsAt/endsAt accept YYYY-MM-DD. The team must belong to the caller's org (else 404). `name` is optional — an unnamed cycle is known by its number, and any number of unnamed cycles is fine — but a name that is set must be unique within the team, compared trimmed and case-insensitively, else 409.