Tags

List tags categories

get

Retrieve a list of tag categories

Authorizations
Path parameters
workspaceIdstringRequired
Query parameters
limitinteger · min: 1 · max: 100Optional

Limits the number of results to return

Default: 10
pageTokenstring · max: 8000Optional

Pagination token that keeps of track of the current position in the list

reversebooleanOptional

Order in which to retrieve the results

Default: false
Responses
200
OK
application/json
Responseall of
get
GET /workspaces/{workspaceId}/tags/categories HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "emoji": "text",
      "createdAt": "text",
      "updatedAt": "text"
    }
  ],
  "nextPageToken": "text",
  "total": 1
}

Create new tag category

post

Create a new category to organize tags based on specific attributes or characteristics.

Authorizations
Path parameters
workspaceIdstringRequired
Body
namestring · min: 3 · max: 25RequiredPattern: ^([a-zA-Z0-9-_]+\s)*[a-zA-Z0-9-_]+$
descriptionstring · max: 1024OptionalPattern: ^(\S.*\S|\S)*$
emojistringRequired
Responses
201
created
post
POST /workspaces/{workspaceId}/tags/categories HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "name": "text",
  "description": "text",
  "emoji": "text"
}

No content

Get tag category

get

Retrieve information about a specific tag category, including its name, description.

Authorizations
Path parameters
workspaceIdstringRequired
categoryIdstringRequired
Responses
200
OK
application/json
get
GET /workspaces/{workspaceId}/tags/categories/{categoryId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "emoji": "text",
  "createdAt": "text",
  "updatedAt": "text"
}

Update tag category

patch

Modify the details of a specific tag category, such as its name, description.

Authorizations
Path parameters
workspaceIdstringRequired
categoryIdstringRequired
Body
namestring · min: 3 · max: 25OptionalPattern: ^([a-zA-Z0-9-_]+\s)*[a-zA-Z0-9-_]+$
descriptionstring · max: 1024OptionalPattern: ^(\S.*\S|\S)*$
emojistringOptional
Responses
200
updated
application/json
patch
PATCH /workspaces/{workspaceId}/tags/categories/{categoryId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "name": "text",
  "description": "text",
  "emoji": "text"
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "emoji": "text",
  "createdAt": "text",
  "updatedAt": "text"
}

Delete tag category

delete

Remove a specific tag category.

Authorizations
Path parameters
workspaceIdstringRequired
categoryIdstringRequired
Responses
204
Deleted
delete
DELETE /workspaces/{workspaceId}/tags/categories/{categoryId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*

No content

List tags

get

Retrieve a list of all tags associated with a specific category.

Authorizations
Path parameters
workspaceIdstringRequired
Query parameters
limitinteger · min: 1 · max: 100Optional

Limits the number of results to return

Default: 10
pageTokenstring · max: 8000Optional

Pagination token that keeps of track of the current position in the list

reversebooleanOptional

Order in which to retrieve the results

Default: false
namestringOptional

Filter by tag name begins with

nameExactstringOptional

Filter by tag name exact match

categoryIdstring · uuidOptional

Filter by tag category ID

statusstring · enumOptional

Filter by tag status

Possible values:
includeDeletedbooleanOptional

Will also return deleted tags

sortBystring · enumOptional

Sort by field specified

Possible values:
Responses
200
OK
application/json
Responseall of
get
GET /workspaces/{workspaceId}/tags HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "status": "draft",
      "category": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "emoji": "text",
        "createdAt": "text",
        "updatedAt": "text"
      },
      "agentCount": 1,
      "itemCount": 1,
      "macroCount": 1,
      "createdAt": "text",
      "updatedAt": "text",
      "deletedAt": "text",
      "lastUsed": {
        "addedToItemAt": "text",
        "addedToItemId": "123e4567-e89b-12d3-a456-426614174000",
        "removedFromItemAt": "text",
        "removedFromItemId": "123e4567-e89b-12d3-a456-426614174000"
      },
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "nextPageToken": "text",
  "total": 1
}

Create new tag

post

Create a new tag within a specific category

Authorizations
Path parameters
workspaceIdstringRequired
Body
namestring · min: 1 · max: 25RequiredPattern: ^([a-zA-Z0-9-_]+\s)*[a-zA-Z0-9-_]+$
descriptionstring · max: 1024OptionalPattern: ^(\S.*\S|\S)*$
statusstring · enumRequiredPossible values:
categoryIdstringOptional
Responses
201
created
post
POST /workspaces/{workspaceId}/tags HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "name": "text",
  "description": "text",
  "status": "draft",
  "categoryId": "text"
}

No content

Get tag

get

Retrieve information about a specific tag, including its name, category id.

Authorizations
Path parameters
workspaceIdstringRequired
tagIdstringRequired
Responses
200
OK
application/json
get
GET /workspaces/{workspaceId}/tags/{tagId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "status": "draft",
  "category": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "emoji": "text",
    "createdAt": "text",
    "updatedAt": "text"
  },
  "agentCount": 1,
  "itemCount": 1,
  "macroCount": 1,
  "createdAt": "text",
  "updatedAt": "text",
  "deletedAt": "text",
  "lastUsed": {
    "addedToItemAt": "text",
    "addedToItemId": "123e4567-e89b-12d3-a456-426614174000",
    "removedFromItemAt": "text",
    "removedFromItemId": "123e4567-e89b-12d3-a456-426614174000"
  },
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Update tag

patch

Modify the details of a specific tag, such as its name.

Authorizations
Path parameters
workspaceIdstringRequired
tagIdstringRequired
Body
namestring · min: 1 · max: 25OptionalPattern: ^([a-zA-Z0-9-_]+\s)*[a-zA-Z0-9-_]+$
descriptionstring · max: 1024OptionalPattern: ^(\S.*\S|\S)*$
statusstring · enumOptionalPossible values:
categoryIdstring | nullableOptional
Responses
200
updated
application/json
patch
PATCH /workspaces/{workspaceId}/tags/{tagId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "name": "text",
  "description": "text",
  "status": "draft",
  "categoryId": "text"
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "status": "draft",
  "category": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "emoji": "text",
    "createdAt": "text",
    "updatedAt": "text"
  },
  "agentCount": 1,
  "itemCount": 1,
  "macroCount": 1,
  "createdAt": "text",
  "updatedAt": "text",
  "deletedAt": "text",
  "lastUsed": {
    "addedToItemAt": "text",
    "addedToItemId": "123e4567-e89b-12d3-a456-426614174000",
    "removedFromItemAt": "text",
    "removedFromItemId": "123e4567-e89b-12d3-a456-426614174000"
  },
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Delete tag

delete

Remove a specific tag.

Authorizations
Path parameters
workspaceIdstringRequired
tagIdstringRequired
Responses
204
Deleted
delete
DELETE /workspaces/{workspaceId}/tags/{tagId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*

No content

List Item Tags

get

Retrieve a list of tags associated with a specific feed item.

Authorizations
Path parameters
workspaceIdstringRequired
feedIdstringRequired

Represents an identifier for feed or feed contents. Supported formats ':' or '::', for example 'channel:747d7564-9ec1-461a-ad3a-2a3a55124917' or 'participant:contact:c453186d-c1e1-494d-9176-1673e1a542ee'

itemIdstringRequired

Feed Item UUID

Query parameters
limitinteger · min: 1 · max: 100Optional

Limits the number of results to return

Default: 10
pageTokenstring · max: 8000Optional

Pagination token that keeps of track of the current position in the list

reversebooleanOptional

Order in which to retrieve the results

Default: false
Responses
200
OK
application/json
Responseall of
get
GET /workspaces/{workspaceId}/feeds/{feedId}/items/{itemId}/tags HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
{
  "results": [
    {
      "itemId": "text",
      "tag": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "status": "draft",
        "category": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "description": "text",
          "emoji": "text",
          "createdAt": "text",
          "updatedAt": "text"
        },
        "agentCount": 1,
        "itemCount": 1,
        "macroCount": 1,
        "createdAt": "text",
        "updatedAt": "text",
        "deletedAt": "text",
        "lastUsed": {
          "addedToItemAt": "text",
          "addedToItemId": "123e4567-e89b-12d3-a456-426614174000",
          "removedFromItemAt": "text",
          "removedFromItemId": "123e4567-e89b-12d3-a456-426614174000"
        },
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "createdAt": "2025-07-10T01:54:50.323Z"
    }
  ],
  "nextPageToken": "text",
  "total": 1
}

Create Item Tag

post

Associate a new tag with a specific feed item, categorizing and labeling it based on specific attributes.

Authorizations
Path parameters
workspaceIdstringRequired
feedIdstringRequired

Represents an identifier for feed or feed contents. Supported formats ':' or '::', for example 'channel:747d7564-9ec1-461a-ad3a-2a3a55124917' or 'participant:contact:c453186d-c1e1-494d-9176-1673e1a542ee'

itemIdstringRequired

Feed Item UUID

Body
tagIdstring · uuid | nullableOptionalDeprecated
tagIdsstring · uuid[] | nullableOptional
Responses
201
Created
application/json
post
POST /workspaces/{workspaceId}/feeds/{feedId}/items/{itemId}/tags HTTP/1.1
Host: 
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "tagIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}
[
  {
    "itemId": "text",
    "tag": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "status": "draft",
      "category": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "emoji": "text",
        "createdAt": "text",
        "updatedAt": "text"
      },
      "agentCount": 1,
      "itemCount": 1,
      "macroCount": 1,
      "createdAt": "text",
      "updatedAt": "text",
      "deletedAt": "text",
      "lastUsed": {
        "addedToItemAt": "text",
        "addedToItemId": "123e4567-e89b-12d3-a456-426614174000",
        "removedFromItemAt": "text",
        "removedFromItemId": "123e4567-e89b-12d3-a456-426614174000"
      },
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "createdAt": "2025-07-10T01:54:50.323Z"
  }
]

Get Item Tag

get

Retrieve information about a specific tag associated with an feed item.

Authorizations
Path parameters
workspaceIdstringRequired
feedIdstringRequired

Represents an identifier for feed or feed contents. Supported formats ':' or '::', for example 'channel:747d7564-9ec1-461a-ad3a-2a3a55124917' or 'participant:contact:c453186d-c1e1-494d-9176-1673e1a542ee'

itemIdstringRequired

Feed Item UUID

tagIdstringRequired
Responses
200
OK
application/json
get
GET /workspaces/{workspaceId}/feeds/{feedId}/items/{itemId}/tags/{tagId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*
{
  "itemId": "text",
  "tag": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "status": "draft",
    "category": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "emoji": "text",
      "createdAt": "text",
      "updatedAt": "text"
    },
    "agentCount": 1,
    "itemCount": 1,
    "macroCount": 1,
    "createdAt": "text",
    "updatedAt": "text",
    "deletedAt": "text",
    "lastUsed": {
      "addedToItemAt": "text",
      "addedToItemId": "123e4567-e89b-12d3-a456-426614174000",
      "removedFromItemAt": "text",
      "removedFromItemId": "123e4567-e89b-12d3-a456-426614174000"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "createdAt": "2025-07-10T01:54:50.323Z"
}

Delete Item Tag

delete

Remove a specific tag associated with an item.

Authorizations
Path parameters
workspaceIdstringRequired
feedIdstringRequired

Represents an identifier for feed or feed contents. Supported formats ':' or '::', for example 'channel:747d7564-9ec1-461a-ad3a-2a3a55124917' or 'participant:contact:c453186d-c1e1-494d-9176-1673e1a542ee'

itemIdstringRequired

Feed Item UUID

tagIdstringRequired
Responses
204
Deleted
delete
DELETE /workspaces/{workspaceId}/feeds/{feedId}/items/{itemId}/tags/{tagId} HTTP/1.1
Host: 
Authorization: Bearer jwt
Accept: */*

No content

Last updated

Was this helpful?