Skip to main content
POST
/
api
/
tags
Create a new tag
curl --request POST \
  --url https://api.mentionlab.io/api/tags \
  --header 'Content-Type: application/json' \
  --header 'x-organisation-id: <x-organisation-id>' \
  --header 'x-project-id: <x-project-id>' \
  --data '
{
  "name": "feature",
  "color": "#3B82F6"
}
'
{
  "id": 1,
  "project": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "name": "feature",
  "color": "#3B82F6"
}

Headers

​
x-organisation-id
string
required

Organisation ID to specify the organisation context

​
x-project-id
string
required

Project ID to specify the project context

Body

application/json
​
name
string
required

Name of the tag

Example:

"feature"

​
color
string
required

Color of the tag in hex format

Example:

"#3B82F6"

Response

201 - application/json
​
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"