Skip to main content
PUT
/
v1
/
groups
/
{id}
/
state
/
tags
/
{tag}
Add a tag to a group
curl --request PUT \
  --url https://api.scrip.dev/v1/groups/{id}/state/tags/{tag} \
  --header 'X-API-Key: <api-key>'
{
  "tag": "vip"
}
Adds a single tag to a group. Tags are normalized to lowercase, so VIP and vip are treated as the same tag. Adding a tag that already exists on the group is a no-op and returns successfully. Tags are part of a group’s state and can be referenced in rule conditions using CEL expressions. They are useful for segmentation and for controlling which rules apply to a group.
For usage patterns and examples, see the State Management guide.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

​
id
string<uuid>
required

Group ID

​
tag
string
required

Tag value to add (max 255 characters)

Response

Tag already existed

​
tag
string

Tag value

Example:

"vip"