Skip to main content
DELETE
/
v1
/
participants
/
{id}
/
state
/
tiers
/
{key}
Remove participant tier
curl --request DELETE \
  --url https://api.scrip.dev/v1/participants/{id}/state/tiers/{key} \
  --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 participant’s current tier level, downgrading them to base (rank 0). The key path parameter identifies which tier to clear (e.g., status), and program_id is required as a query parameter. Any pending tier expiration tasks for this assignment are also cancelled. The participant must be active and enrolled in the specified program. The program must also be active.
For usage patterns and examples, see the Tiers 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

​
key
string
required

Tier key (e.g., status)

Query Parameters

​
program_id
string<uuid>
required

Program ID

Response

Tier removed