Skip to main content
POST
/
v1
/
projects
/
{projectId}
/
tags
curl --request POST \
  --url https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/tags \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Q1-2026",
    "promptIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890", "b2c3d4e5-f6a7-8901-bcde-f12345678901"]
  }'

import requests

payload = {
    "name": "Q1-2026",
    "promptIds": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    ],
}
r = requests.post(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/tags",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    json=payload,
)
print(r.json()["data"])

{
  "data": {
    "tag": "Q1-2026",
    "appliedTo": 2
  }
}
Adds a tag to one or more prompts. The tag is merged with existing prompt tags so you can organize Finseo tracking cohorts without replacing other labels.
​
projectId
string
required
Project identifier.
​
name
string
required
Tag name (1–100 characters).
​
promptIds
array
required
Non-empty list of prompt UUIDs to update.
curl --request POST \
  --url https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/tags \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Q1-2026",
    "promptIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890", "b2c3d4e5-f6a7-8901-bcde-f12345678901"]
  }'

import requests

payload = {
    "name": "Q1-2026",
    "promptIds": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    ],
}
r = requests.post(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/tags",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    json=payload,
)
print(r.json()["data"])

{
  "data": {
    "tag": "Q1-2026",
    "appliedTo": 2
  }
}