Skip to main content
POST
/
tags
/
categories
/
import requests

response = requests.post(
    "https://api.atomscale.ai/tags/categories/",
    headers={
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "name": "Review Status"
    }
)
category = response.json()

{
  "id": "b1a2c3d4-1111-2222-3333-444455556666",
  "name": "Review Status",
  "organization_id": "org_abc123",
  "tag_count": 0
}
Creates a new tag category for your organization. Categories group related tags together. Optionally provide an explicit id.
​
name
string
required
Category name
​
id
string
Explicit UUID to use for the category. If omitted, the server generates one.

​
Response

Returns the created category.
​
id
string
Tag category UUID
​
name
string
Category name
​
organization_id
string
ID of the organization the category belongs to
​
tag_count
integer
Number of tags that belong to this category
import requests

response = requests.post(
    "https://api.atomscale.ai/tags/categories/",
    headers={
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "name": "Review Status"
    }
)
category = response.json()

{
  "id": "b1a2c3d4-1111-2222-3333-444455556666",
  "name": "Review Status",
  "organization_id": "org_abc123",
  "tag_count": 0
}