Skip to main content
POST
/
tags
curl --request POST \
  --url https://api.coval.dev/v1/tags \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "tag_name": "production"
}
'
{
  "tag": {
    "name": "tags/01HX2ABC3DEF4GHI5JKL6MNO7P",
    "id": "01HX2ABC3DEF4GHI5JKL6MNO7P",
    "tag_name": "production",
    "color": "#3b82f6",
    "create_time": "2025-10-14T12:00:00Z",
    "created_by": "engineer@example.com"
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
tag_name
string
required

Tag display name. Normalized to lowercase before persistence.

Required string length: 1 - 200
Example:

"Production"

color
string | null

Optional hex color code (#RGB,

Maximum string length: 9
Pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$
Example:

"#3b82f6"

Response

Tag created successfully

tag
object
required

Tag resource. Tags are used to organize agents, personas, test sets, metrics, and run templates.