Labels
Authorization
apiKey Workspace scoped API key, printed once by pnpm seed or POST /api-keys.
In: header
Query Parameters
Set to 1 to add issueCount and openIssueCount across every team. Admin only
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/labels"{ "labels": [ { "id": "string", "name": "string", "color": "string", "description": "string", "issueCount": 0, "openIssueCount": 0 } ]}Authorization
apiKey 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/labels" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "label": { "id": "string", "name": "string", "color": "string", "description": "string" }}A rename keeps the id, so issue links follow it, and rewrites saved view and view default label filters in the same transaction. 409 when another label already has the name; merge instead.
Authorization
apiKey Workspace scoped API key, printed once by pnpm seed or POST /api-keys.
In: header
Path Parameters
Label id
Request 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/labels/string" \ -H "Content-Type: application/json" \ -d '{}'{ "label": { "id": "string", "name": "string", "color": "string", "description": "string" }}Removes it from every issue and from saved view filters.
Authorization
apiKey Workspace scoped API key, printed once by pnpm seed or POST /api-keys.
In: header
Path Parameters
Label id
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/labels/string"{ "deleted": true}Moves every issue link to the target, collapses issues that already carry it, rewrites saved filters, deletes the source and records a labels_changed event per affected issue.
Authorization
apiKey Workspace scoped API key, printed once by pnpm seed or POST /api-keys.
In: header
Path Parameters
Source label id, deleted by the merge
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/labels/string/merge" \ -H "Content-Type: application/json" \ -d '{ "into": "string" }'{ "label": { "id": "string", "name": "string", "color": "string", "description": "string" }, "moved": 0, "collapsed": 0}