Rename a cycle
The one field of a cycle still changeable by hand. number and dates are roller-owned and no longer accepted here — send them and they are silently ignored, the same as any unknown field on any PATCH body in this service. There is no delete: a cycle cannot be removed once the roller has made it. A name another cycle in the same team already uses is a 409, compared trimmed and case-insensitively; "" clears the name and never collides with another blank one. A cycle's team is immutable, so teamId is not accepted. Cycles in another org read as 404.
View as MarkdownAuthorization
bearer In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/cycles/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{ "cycle": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "number": 0, "name": "string", "startsAt": "2019-08-24", "endsAt": "2019-08-24" }}List cycles
Cycles across the org's teams, highest number first. Filter with team_id. No create here. Cycles are roller-owned: a team gets them by turning on `cyclesEnabled` in PATCH /v1/teams/{id}/settings, and a background job creates, numbers and dates every one from that team's cadence. A create route used to exist and was removed — a hand-made cycle could straddle a boundary the scheduler was about to place there itself.
List imports, newest first
Administrators only (`org.settings.manage`): a job carries the names and emails the uploaded file contained. Imports in another workspace are never listed. `team_id` narrows to one team (404 if the team is not one the caller can reach). `batch_id` narrows to the imports of one batch (400 if it is not an id). `limit` defaults to 20, maximum 50, which is also the most a batch can hold.