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"
}
}
Tags
Create tag
Create a new tag. Tag names are normalized to lowercase before persistence. Returns 409 if a tag with the same name already exists and is active. Reusing a deleted name reactivates the same tag without restoring prior assignments.
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
API key for authentication
Headers
Workspace that scopes this operation. When omitted, the organization's active default workspace is used when one can be resolved.
Required string length:
1 - 26Body
application/json
Response
Tag created successfully
Tag resource. Tags are used to organize agents, personas, test sets, metrics, and run templates.
Show child attributes
Show child attributes
Was this page helpful?