Model: HoldoutRequestBody
1 min
Model Parameters
object
Request body schema for creating or updating a holdout.
Holdouts are experiments that reserve a portion of your traffic to measure the impact of your feature flags and experiments. They help establish a control group by excluding a percentage of users from seeing any experiments, allowing you to measure the overall impact of your experimentation program.
NOTE: This schema is shared between two endpoints with different validation rules:
- POST /projects//holdouts: project_id, project_ids, and rule_ids from the body are ignored (project comes from URL)
- POST /holdouts: project_id is required in the body, plus either project_ids (global) or rule_ids (local)
These constraints are enforced at runtime by the API, not by OpenAPI schema validation.