Tags
Create a tag
Create a reusable workspace tag.
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
A workspace API key beginning with biqli_.
Body
application/json

