Tags

Tag management operations

List all tags

get

Returns all tags accessible to the authenticated user

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Responses

200

List of tags

application/json

idintegerRequired

Unique tag identifier

Example: 1

namestringRequired

Tag name

Example: High Priority

colorstringRequired

Tag color (hex code)

Example: #FF5733

categoryIdinteger · nullableOptional

Parent category ID

parentIdinteger · nullableOptional

Parent tag ID for hierarchical tags

isGlobalbooleanRequired

Whether the tag is available globally

Example: true

createdAtstring · date-timeRequired

Creation timestamp

401

Not authenticated

500

Server error

get/tags

HTTPcURLJavaScriptPython

GET /api/tags HTTP/1.1
Accept: */*

[
  {
    "id": 1,
    "name": "High Priority",
    "color": "#FF5733",
    "categoryId": 1,
    "parentId": 1,
    "isGlobal": true,
    "createdAt": "2026-07-11T04:05:25.165Z"
  }
]

Create a new tag

post

Creates a new tag. Requires manage_tags permission.

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Body

application/json

namestringRequired

Tag name

Example: Urgent

colorstringRequired

Tag color (hex code)

Example: #E74C3C

categoryIdinteger · nullableOptional

Parent category ID

parentIdinteger · nullableOptional

Parent tag ID

isGlobalbooleanOptionalDefault: true

Responses

200

Tag created successfully

application/json

idintegerRequired

Unique tag identifier

Example: 1

namestringRequired

Tag name

Example: High Priority

colorstringRequired

Tag color (hex code)

Example: #FF5733

categoryIdinteger · nullableOptional

Parent category ID

parentIdinteger · nullableOptional

Parent tag ID for hierarchical tags

isGlobalbooleanRequired

Whether the tag is available globally

Example: true

createdAtstring · date-timeRequired

Creation timestamp

400

Validation error

401

Not authenticated

403

Permission denied

500

Server error

post/tags

HTTPcURLJavaScriptPython

POST /api/tags HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "name": "Urgent",
  "color": "#E74C3C",
  "categoryId": 1,
  "parentId": 1,
  "isGlobal": true
}

{
  "id": 1,
  "name": "High Priority",
  "color": "#FF5733",
  "categoryId": 1,
  "parentId": 1,
  "isGlobal": true,
  "createdAt": "2026-07-11T04:05:25.165Z"
}

Add a tag to a project

post

Associates a tag with a project

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

projectIdintegerRequired

Project ID

Body

application/json

tagIdintegerRequired

Tag ID to add

Responses

200

Tag added to project successfully

No content

401

Not authenticated

403

Permission denied

404

Project or tag not found

500

Server error

post/projects/{projectId}/tags

HTTPcURLJavaScriptPython

POST /api/projects/{projectId}/tags HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 11

{
  "tagId": 1
}

No content

Remove a tag from a project

delete

Removes the association between a tag and a project

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

projectIdintegerRequired

Project ID

tagIdintegerRequired

Tag ID

Responses

204

Tag removed from project successfully

No content

401

Not authenticated

403

Permission denied

404

Association not found

500

Server error

delete/projects/{projectId}/tags/{tagId}

HTTPcURLJavaScriptPython

DELETE /api/projects/{projectId}/tags/{tagId} HTTP/1.1
Accept: */*

No content

Manage project tags

post

Updates the set of tags associated with a project

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

projectIdintegerRequired

Project ID

Body

application/json

tagIdsinteger[]Required

List of tag IDs to associate with the project

Responses

200

Project tags updated successfully

No content

401

Not authenticated

403

Permission denied

500

Server error

post/projects/{projectId}/project-tags

HTTPcURLJavaScriptPython

POST /api/projects/{projectId}/project-tags HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "tagIds": [
    1
  ]
}

No content