Create tag

PUT

/api/v1/tag

const url = 'https://example.com/api/v1/tag';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: '{"name":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://example.com/api/v1/tag \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example" }'

Request Body^required

application/json

object

name

required

Plain-text tag name. Empty names, Unicode, punctuation, and literal markup are preserved. C0 and DEL controls are rejected. Length is measured in Unicode code points.

string

<= 5000 characters /^[^\u0000-\u001f\u007f]*$(?![\s\S])/

Example^generated

{
  "name": "example"
}

Responses

201

Tag created

application/json

object

required

Tag ID (15 chars)

string

name

required

Tag name

string

created

string format: date-time

updated

string format: date-time

Example^generated

{
  "id": "example",
  "name": "example",
  "created": "2026-04-15T12:00:00Z",
  "updated": "2026-04-15T12:00:00Z"
}

400

Bad Request

500

Internal Server Error

Create tag

Request Bodyrequired

Examplegenerated

Responses

201

Examplegenerated

400

500

Request Body^required

Example^generated

Example^generated