Skip to main content
PUT
/
v1
/
groups
/
{id}
/
state
/
tags
Set group tags
curl --request PUT \
  --url https://api.scrip.dev/v1/groups/{id}/state/tags \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "tags": [
    "vip"
  ]
}
'
{
  "tags": [
    "vip"
  ]
}
Replaces all tags on a group with the provided list. Any existing tags not in the new list are removed. To add or remove individual tags without replacing the full set, use the add or remove tag endpoints instead.
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

Body

application/json

Tags to set

​
tags
string[]
required

Tags to set. Replaces all existing tags

Example:
["vip"]

Response

Tags replaced

​
tags
string[]

Participant's tags

Example:
["vip"]