Create a new tag

Create a new tag for organizing documents, templates, or contacts.

Required Fields:

• name - Tag name (must be unique)
• availableFor - Where tag can be used: DOCUMENT, TEMPLATE, or CONTACT

Optional Fields:

• color - Hex color code (e.g., #FF5733)

POST /api/v1/tags

Create a new tag

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/tags \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>",
  "availableFor": [
    "DOCUMENT"
  ],
  "color": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "color": "<string>",
  "availableFor": [
    "<string>"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Headers

authorization · string · required

Bearer token for API authentication

Body

application/json

Body

Create tag request

name · string · required

Tag name (required)

Minimum string length: 1

availableFor · enum<string>[] · required

Where this tag can be used

Minimum array length: 1

Available options: DOCUMENT, TEMPLATE, CONTACT

color · string

Tag color in hex format (e.g., #FF5733)

Pattern: ^#[0-9A-F]{6}$

Response

200

application/json

200

id · string · required

Unique tag identifier

name · string · required

Tag name

color · string · required

Tag color in hex format (e.g., #FF5733)

availableFor · string[] · required

Where this tag can be used: DOCUMENT, TEMPLATE, and/or CONTACT

createdAt · string<date-time> · required

Date and time when tag was created

updatedAt · string<date-time> · required

Date and time when tag was last updated