Skip to main content
POST
Create tag

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of create_tag.

name
string
required

Label text; the (team_sid, name) dedup key - compared case-insensitively against live tags, stored as entered.

Required string length: 1 - 255
color
string | null

Chip color "#rrggbb", lowercase hex. Default null = client default palette.

Required string length: 7
Pattern: ^#[0-9a-f]{6}$

Response

create success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
create
item
object
required
already_exists
boolean
required
meta
object
required