Skip to main content
POST
Create a new tag

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json

Request body for creating a tag

name
string
required

Tag name

Required string length: 1 - 255
Example:

"Demo"

color
string

Hex color (default: derived deterministically from the name)

Pattern: ^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$
Example:

"#6366f1"

description
string

Optional tag description

Maximum string length: 5000
Example:

"Product demo recordings"

scope
enum<string>

Tag visibility (default: workspace)

Available options:
workspace,
private
Example:

"workspace"

Response

Created

The created tag

tag
object
required

A tag used to categorize videos