Skip to main content
POST
/
api
/
tags
/
many
Create multiple tags
curl --request POST \
  --url https://api.mentionlab.io/api/tags/many \
  --header 'Content-Type: application/json' \
  --header 'x-project-id: <x-project-id>' \
  --data '
{
  "tags": [
    {
      "name": "Marketing",
      "color": "#3B82F6"
    },
    {
      "name": "Product Launch",
      "color": "#10B981"
    }
  ]
}
'
[
  {
    "id": 1,
    "project": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "name": "feature",
    "color": "#3B82F6",
    "queryCount": 5
  }
]

Headers

​
x-project-id
string
required

Project ID to specify the project context

Body

application/json
​
tags
object[]
required

List of tags to create in a single batch operation. Must contain at least one tag, and each entry is validated against the CreateTagDto schema.

Example:
[
  { "name": "Marketing", "color": "#3B82F6" },
  {
    "name": "Product Launch",
    "color": "#10B981"
  }
]

Response

​
id
number
required

Unique identifier for the tag

Example:

1

​
project
object
required

The project this tag belongs to

Example:

"a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6"

​
name
string
required

Name of the tag

Example:

"feature"

​
color
string
required

Color of the tag in hex format

Example:

"#3B82F6"

​
queryCount
number

Number of queries associated with this tag

Example:

5