Add a tag to a changelog

Associate a tag with a changelog entry.

Introduction

The FeatureOS add a tag to a changelog API allows you to associate a tag with a changelog. You can pass a tag_id to associate an existing tag, or use the value parameter to find or create a tag by name.

POST https://api.featureos.app/api/v3/changelogs/:id/changelog_categories

curl -X POST 'https://api.featureos.app/api/v3/changelogs/:id/changelog_categories' \
  -H 'API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

const response = await fetch('https://api.featureos.app/api/v3/changelogs/:id/changelog_categories', {
  method: 'POST',
  headers: {
    'API-KEY': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.featureos.app/api/v3/changelogs/:id/changelog_categories',
    headers={
        'API-KEY': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
)
data = response.json()

Headers

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

Query Parameters

Parameter	Required	Format	Description
id	true	Integer	The ID of the changelog
tag_id	false	Integer	The ID of an existing changelog tag. If provided, this takes priority over the `value` parameter. You can retrieve available changelog tag IDs using the List all tags API with `source_type=changelog`.
value	false	String / Integer	When `tag_id` is not provided: pass a tag name to find or create a tag by name, or pass a tag ID to find an existing tag.

Sample response

{
  "id": 1,
  "slug": "bug-fix",
  "name": "Bug Fix",
  "description": null,
  "color": "#FF6B6B",
  "private": false,
  "source_type": "changelog",
  "source_id": null
}