Tags

Retrieve all tags

get

Retrieve all tags in a workspace.

Responses

200

All tags in a workspace.

application/json

401

The user is not authenticated.

403

The user does not have permission to perform this operation.

get

/tags

HTTPcURLJavaScriptPython

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

[
  {
    "id": "981ba079-62a6-442c-8dfb-a72af6e96b8c",
    "name": "Tag Name",
    "color": "BLUE",
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-01-01T00:00:00.000Z"
  }
]

Create a new tag

post

Create a new tag.

Body

application/json

namestringRequired

The tag's name.

Example: Qualified

colorstring · enumRequired

The tag's color.

Possible values:

Responses

201

The tag that was created.

application/json

401

The user is not authenticated.

403

The user does not have permission to perform this operation.

post

/tags

HTTPcURLJavaScriptPython

POST /api/v1/tags HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "name": "Qualified",
  "color": "BLUE"
}

{
  "id": "981ba079-62a6-442c-8dfb-a72af6e96b8c",
  "name": "Tag Name",
  "color": "BLUE",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Retrieve a single tag

get

Retrieve a tag by its ID.

Path parameters

tagIdstringRequired

The tag's ID.

Example: 981ba079-62a6-442c-8dfb-a72af6e96b8c

Responses

200

A tag.

application/json

401

The user is not authenticated.

403

The user does not have permission to perform this operation.

get

/tags/{tagId}

HTTPcURLJavaScriptPython

GET /api/v1/tags/{tagId} HTTP/1.1
Host: 
Accept: */*

{
  "id": "981ba079-62a6-442c-8dfb-a72af6e96b8c",
  "name": "Tag Name",
  "color": "BLUE",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Update a tag

patch

Update a tag.

Path parameters

tagIdstringRequired

The tag's ID.

Example: 981ba079-62a6-442c-8dfb-a72af6e96b8c

Body

application/json

namestringRequired

The tag's name.

Example: Qualified

colorstring · enumRequired

The tag's color.

Possible values:

Responses

200

The tag that was updated.

application/json

401

The user is not authenticated.

403

The user does not have permission to perform this operation.

patch

/tags/{tagId}

HTTPcURLJavaScriptPython

PATCH /api/v1/tags/{tagId} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "name": "Qualified",
  "color": "BLUE"
}

{
  "id": "981ba079-62a6-442c-8dfb-a72af6e96b8c",
  "name": "Tag Name",
  "color": "BLUE",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Delete a tag

delete

Delete a tag.

Path parameters

tagIdstringRequired

The tag's ID.

Example: 981ba079-62a6-442c-8dfb-a72af6e96b8c

Responses

200

The tag that was deleted.

application/json

401

The user is not authenticated.

403

The user does not have permission to perform this operation.

delete

/tags/{tagId}

HTTPcURLJavaScriptPython

DELETE /api/v1/tags/{tagId} HTTP/1.1
Host: 
Accept: */*

{
  "id": "981ba079-62a6-442c-8dfb-a72af6e96b8c",
  "name": "Tag Name",
  "color": "BLUE",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}