POST
/
console
/
v1
/
holdouts
Create holdout
curl --request POST \
  --url https://statsigapi.net/console/v1/holdouts \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '{
  "name": "team holdout",
  "description": "holdout for this team",
  "idType": "userID",
  "teamID": "4pjeXYDjC2WinSgOiII7wh"
}'
{
  "message": "Holdout created successfully.",
  "data": {
    "id": "a_holdout",
    "name": "a holdout",
    "description": "helpful summary of what this holdout does",
    "idType": "userID",
    "lastModifierID": "1vaQaBoLlkauH9iiuOSBP2",
    "lastModifiedTime": 1707768016211,
    "lastModifierName": "CONSOLE API",
    "lastModifierEmail": null,
    "creatorID": "1vaQaBoLlkauH9iiuOSBP2",
    "createdTime": 1707768015729,
    "creatorName": "CONSOLE API",
    "creatorEmail": null,
    "targetApps": [],
    "tags": [],
    "team": "Console Team",
    "isEnabled": true,
    "isGlobal": false,
    "passPercentage": 0,
    "gateIDs": [],
    "experimentIDs": [],
    "layerIDs": [],
    "targetingGateID": null
  }
}

Authorizations

​
STATSIG-API-KEY
string
header
required

Headers

​
x-respect-review-settings
string

Optional header to respect review settings for mutation endpoints.

Body

application/json

Response

200
application/json

Create holdout response

The response is of type object.