Skip to main content
POST
/
v1
/
tags
Create tag
curl --request POST \
  --url https://api.uselora.com/v1/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "color": "DEFAULT"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "workspaceId": "<string>",
  "creatorId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://uselora.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Payload to create a new tag

​
name
string
required

The tag name (3..50 chars). The slug is derived from this server-side and updates whenever name changes.

Required string length: 3 - 50
Example:

"Marketing"

​
color
enum<string>
default:DEFAULT

Tag color

Available options:
DEFAULT,
GRAY,
BROWN,
ORANGE,
YELLOW,
GREEN,
BLUE,
PURPLE,
PINK,
RED
Example:

"BLUE"

Response

The created tag.

A tag.

​
id
string
required

Stable 8-char Crockford-base32 handle (no i/l/o/u). Use this in URL paths and to address the tag via the API.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$
Example:

"a1b2c3d4"

​
name
string
required
​
slug
string
required
​
color
enum<string>
required
Available options:
DEFAULT,
GRAY,
BROWN,
ORANGE,
YELLOW,
GREEN,
BLUE,
PURPLE,
PINK,
RED
​
workspaceId
string
required

ID of the workspace the tag belongs to.

​
creatorId
string
required

ID of the user who created the tag.

​
createdAt
string
required

ISO 8601 creation timestamp.

​
updatedAt
string
required

ISO 8601 timestamp of the last update.