Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-25173140700.7 KB
Tag

Create a tag

Create a new tag in the caller's tenant.

post/tags/

Query parameters

cookie_namestring nullable

Request body

namestring required

Tag label, unique per tenant. Leading/trailing whitespace is stripped.

Example request

{
  "name": "finance"
}

Response

Successful Response

created_atstring date-time

UTC timestamp when the record was created.

updated_atstring date-time

UTC timestamp when the record was last updated.

idinteger nullable

Primary key for the tag.

tenant_idinteger required

ID of the tenant that owns the tag.

namestring required

Name of the tag.

creator_user_idinteger nullable

ID of the user who created the tag.

updater_user_idinteger nullable

ID of the user who last updated the tag.

Example response

{
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-16T08:00:00Z",
  "id": 1,
  "tenant_id": 1,
  "name": "urgent",
  "updater_user_id": 1
}