VoidTrack Docs
API Reference

Cycles

GET
/cycles
AuthorizationBearer <token>

Workspace scoped API key, printed once by pnpm seed or POST /api-keys.

In: header

Query Parameters

team*string

Team key or id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/cycles?team=string"
{  "cycles": [    {      "id": "string",      "number": 0,      "name": "string",      "startsAt": "2019-08-24T14:15:22Z",      "endsAt": "2019-08-24T14:15:22Z",      "isActive": true    }  ]}
POST
/cycles

Rolls unfinished issues from the previous cycle into the new one unless rollover is false.

AuthorizationBearer <token>

Workspace scoped API key, printed once by pnpm seed or POST /api-keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/cycles" \  -H "Content-Type: application/json" \  -d '{    "team": "string"  }'
{  "cycle": {    "id": "string",    "number": 0,    "name": "string",    "startsAt": "2019-08-24T14:15:22Z",    "endsAt": "2019-08-24T14:15:22Z",    "isActive": true  },  "rolledOver": 0}
PATCH
/cycles/{id}
AuthorizationBearer <token>

Workspace scoped API key, printed once by pnpm seed or POST /api-keys.

In: header

Path Parameters

id*string

Cycle id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/cycles/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "cycle": {    "id": "string",    "number": 0,    "name": "string",    "startsAt": "2019-08-24T14:15:22Z",    "endsAt": "2019-08-24T14:15:22Z",    "isActive": true  }}
DELETE
/cycles/{id}
AuthorizationBearer <token>

Workspace scoped API key, printed once by pnpm seed or POST /api-keys.

In: header

Path Parameters

id*string

Cycle id

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/cycles/string"
{  "deleted": true}