Skip to main content
DELETE
/
v1
/
participants
/
{id}
/
state
/
tags
/
{tag}
Remove tag from participant
curl --request DELETE \
  --url https://api.scrip.dev/v1/participants/{id}/state/tags/{tag} \
  --header 'X-API-Key: <api-key>'
{
  "code": "bad_request",
  "details": {
    "expected": "present",
    "field": "amount",
    "message": "This field is required",
    "reason": "required",
    "received": "<string>"
  },
  "message": "Invalid request parameters"
}
Removes a single tag from a participant. The tag name is passed as a path parameter. If the tag does not exist on the participant, this call is a no-op and returns successfully. There is no need to check for tag existence before calling this endpoint. Returns 204 No Content on success.
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 remove

Response

Tag removed