Skip to main content
POST
Create a tag
POST /v1/tag requires Tags: Write (tags.create).
display_name is required (2–100 characters). color is optional and accepts blue, green, yellow, red, gray, purple, pink, or cyan. Use gray, null, or omit color for the default gray style. Biqli stores and returns that default as null. Biqli generates the normalized name. Success returns 201 Created with a complete tag containing its biq_tag_... ID, names, color, link count, and timestamps. Duplicate normalized names return 409 tag_name_taken; unsupported colors return 422 validation_error; quota and plan restrictions still apply.

Shared API behavior

Authentication is workspace-scoped; see Authentication. Errors use the standard envelope and request IDs described in Errors, and requests are subject to Rate limits.

Authorizations

Authorization
string
header
required

A workspace API key beginning with biqli_.

Body

application/json
display_name
string
required
Required string length: 2 - 100
color
enum<string> | null

Supported dashboard color. gray and null both select the default gray style, which responses represent as null.

Available options:
blue,
green,
yellow,
red,
gray,
purple,
pink,
cyan,
null

Response

Tag created.

tag
object
required
status
string
required
Allowed value: "success"