VoidTrack Docs
API Reference

Views

List the baseline filters built-in views open with

GET
/view-defaults

Your own overrides plus the workspace baselines. Where both exist for a view key, yours applies.

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Query Parameters

viewKey?string

Limit to one view key

Response Body

application/json

application/json

curl -X GET "https://example.com/view-defaults"
{  "defaults": [    {      "viewKey": "string",      "scope": "user",      "filters": {        "property1": null,        "property2": null      },      "sort": "string",      "display": "string",      "grouping": "string",      "hidden": [        "string"      ]    }  ]}

Clear a view default

DELETE
/view-defaults

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Query Parameters

viewKey*string

View key

scope?string

user (default) or workspace

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/view-defaults?viewKey=string"
{  "ok": true}

Set what a built-in view opens with

PUT
/view-defaults

Scope 'workspace' sets the baseline for everyone and is admin only.

Authorization

apiKey
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 PUT "https://example.com/view-defaults" \  -H "Content-Type: application/json" \  -d '{    "viewKey": "string"  }'
{  "default": {    "viewKey": "string",    "scope": "user",    "filters": {      "property1": null,      "property2": null    },    "sort": "string",    "display": "string",    "grouping": "string",    "hidden": [      "string"    ]  }}

List your saved views

GET
/views

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/views"
{  "views": [    {      "id": "string",      "name": "string",      "kind": "issues",      "team": "string",      "display": "list",      "grouping": "status",      "filters": {        "property1": null,        "property2": null      },      "sort": "string",      "favorite": true    }  ]}

Create a saved view

POST
/views

Authorization

apiKey
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

curl -X POST "https://example.com/views" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "view": {    "id": "string",    "name": "string"  }}

Update a saved view

PATCH
/views/{id}

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

View 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/views/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "ok": true}

Delete a saved view

DELETE
/views/{id}

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

View id

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/views/string"
{  "ok": true}

Updates

Previous Page

Workspace

Next Page