Skip to main content
DELETE
Remove participant tier
Removes a participant’s current tier level, resetting 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. Returns 204 No Content on success. The participant must be active and enrolled in the specified program. The program must also be active. Inactive participants return 409 Conflict with code participant_inactive.
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