website/docs/discord-experiments-api/eligible.md

2.5 KiB

title description
Eligible How to check if a guild is eligible for an experiment

Eligible

This section of the documentation will cover how to check if a guild is eligible for an experiment.

Accessible on https://api.discord-experiments.xhyrom.dev/v2/eligible

Eligible Object

Represents the eligibility of a guild for an experiment

Eligible Structure:

field type description
eligible boolean Whether the guild is eligible for the experiment or not
bucket * bucket The bucket of the guild
filters array of filter The filters that haven't been checked
is_override_formatted boolean Whether the guild is in overrides_formatted

* Includes id field - id of the bucket

Checking eligibility

You can check if a guild is eligible for an experiment by sending a POST request to https://api.discord-experiments.xhyrom.dev/v2/eligible

Body:

field type description
experiment_id string The id of the experiment to check eligibility for
guild * guild The guild to check eligibility for

* Only id, features and member_count fields are checked and id is required

POST https://api.discord-experiments.xhyrom.dev/v2/eligible

{
  "experiment_id": "2023-03_clyde_ai",
  "guild": {
    "id": "1046534628577640528",
    "features": ["COMMUNITY"],
    "member_count": 100
  }
}

Returns an eligible object