Skip to main content
POST
https://dashboard.laburen.com
/
api
/
annotations
/
tags
curl --location --request POST 'https://dashboard.laburen.com/api/annotations/tags' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data-raw '{
    "name": "bug"
}'
{
  "id": "clxxxxxxxxxxxxxxxxx",
  "name": "bug",
  "organizationId": "clxxxxxxxxxxxxxxxxx",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:30:00.000Z"
}
This endpoint creates a new annotation tag for the authenticated user’s organization. It supports:
  • Creating tags with unique names per organization
  • Automatic duplicate detection (prevents creating tags with the same name)

Body

Required

name
string
required
The name of the annotation tag. Must be unique within the organization.

Response

id
string
Unique identifier of the created annotation tag (CUID format).
name
string
Name of the annotation tag.
organizationId
string
ID of the organization the tag belongs to.
createdAt
string
ISO 8601 timestamp of when the tag was created.
updatedAt
string
ISO 8601 timestamp of when the tag was last updated.

Error Responses

Status CodeTypeDescription
401UNAUTHORIZEDMissing or invalid authentication session.
409ALREADY_EXISTSA tag with the same name already exists in the organization.
curl --location --request POST 'https://dashboard.laburen.com/api/annotations/tags' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data-raw '{
    "name": "bug"
}'
{
  "id": "clxxxxxxxxxxxxxxxxx",
  "name": "bug",
  "organizationId": "clxxxxxxxxxxxxxxxxx",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:30:00.000Z"
}