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": "uuid",
    "field": "asset_id",
    "fields": [
      {
        "expected": "<unknown>",
        "field": "amount",
        "message": "This field is required",
        "reason": "required",
        "received": "<string>"
      }
    ],
    "reason": "invalid",
    "received": "<string>"
  },
  "message": "Invalid request parameters"
}

Documentation Index

Fetch the complete documentation index at: https://docs.scrip.dev/llms.txt

Use this file to discover all available pages before exploring further.

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