Skip to main content
PUT
Add tag to participant (idempotent)
Adds a single tag to a participant. The tag name is passed as a path parameter and is normalized to lowercase. If the tag already exists on the participant, this call is a no-op and returns successfully. This makes the endpoint safe to call repeatedly without side effects.
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

Participant ID

tag
string
required

Tag to add

Response

Tag already existed

tag
string

Tag value

Example:

"vip"