Skip to main content
POST
/
tags
/
import requests

response = requests.post(
    "https://api.atomscale.ai/tags/",
    headers={
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "name": "high-priority",
        "tag_category_id": "b1a2c3d4-1111-2222-3333-444455556666"
    }
)
tag = response.json()

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "high-priority",
  "organization_id": "org_abc123",
  "tag_category_id": "b1a2c3d4-1111-2222-3333-444455556666",
  "category_name": "Review Status",
  "usage_count": 0
}
Creates a new tag for your organization. Optionally assign the tag to a category, or provide an explicit id.
​
name
string
required
Tag name
​
tag_category_id
string
ID of the category to assign this tag to
​
id
string
Explicit UUID to use for the tag. If omitted, the server generates one.

​
Response

Returns the created tag.
​
id
string
Tag UUID
​
name
string
Tag name
​
organization_id
string
ID of the organization the tag belongs to
​
tag_category_id
string
ID of the category this tag belongs to, or null if uncategorized
​
category_name
string
Name of the tag’s category, or null if uncategorized
​
usage_count
integer
Number of data items this tag is applied to
import requests

response = requests.post(
    "https://api.atomscale.ai/tags/",
    headers={
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "name": "high-priority",
        "tag_category_id": "b1a2c3d4-1111-2222-3333-444455556666"
    }
)
tag = response.json()

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "high-priority",
  "organization_id": "org_abc123",
  "tag_category_id": "b1a2c3d4-1111-2222-3333-444455556666",
  "category_name": "Review Status",
  "usage_count": 0
}