Create a tag

Introduction

This API enables you to add new tags that can be either global or specific to a board.

POST https://api.featureos.app/api/v3/tags

Headers

Parameter	Default	Description
API-KEY	-	Generate from organization settings on the admin dashboard.
Authorization	-	Generate a unique JWT token specific to a user.

Body Parameters

Parameter	Default	Description
id	-	The ID of the tag returned in the list tags endpoint.
name	-	The name of the tag returned in the list tags endpoint.
color	-	The color of the tag - ["gray", "red", "yellow", "green", "cyan", "teal", "blue", "indigo", "purple", "rose", "light_gray", "violet", "orange"]
source_type	-	The type of source under which the tag is created - ["bucket" - Board specific tag (or) "feature_request" - Global tag]
source_id	-	The ID of the source under which the tag is created.
description	-	A description of the tag.
private	-	Indicates whether the tag is private or public.

Sample response

  {
    "id": 123,
    "slug": "2025-Quarter-1",
    "name": "2025 Quarter 1",
    "description": "ETC quarter",
    "color": "orange",
    "private": true,
    "source_type": "bucket",
    "source_id": 12
  }