Skip to main content
POST
/
console
/
v1
/
holdouts
/
{id}
Update holdout by id
curl --request POST \
  --url https://statsigapi.net/console/v1/holdouts/{id} \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '{
  "isEnabled": true,
  "description": "example holdout description",
  "passPercentage": 5,
  "gateIDs": [
    "4pjeXYDjC2WinSgOiII7wh"
  ],
  "experimentIDs": [
    "70fCNphHGesdLwHdHau99q"
  ],
  "layerIDs": [
    "5O908pyGoCqw6QH1nt8v82"
  ],
  "isGlobal": false,
  "targetingGateID": "4pjeXYDjC2WinSgOiII7wh",
  "monitoringMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ]
}'
{
  "message": "Holdout updated successfully.",
  "data": {
    "id": "testing_holdout",
    "name": "testing holdout",
    "description": "UPDATED summary of what this holdout does",
    "idType": "userID",
    "lastModifierID": "4dcQUIpS8PHObBGD7HJwOx",
    "lastModifiedTime": 1719941188286,
    "lastModifierName": "CONSOLE API",
    "lastModifierEmail": null,
    "creatorID": "4dcQUIpS8PHObBGD7HJwOx",
    "createdTime": 1719873870785,
    "creatorName": "CONSOLE API",
    "creatorEmail": null,
    "targetApps": [],
    "tags": [],
    "team": "Console Team",
    "isEnabled": true,
    "isGlobal": true,
    "passPercentage": 5,
    "gateIDs": [],
    "experimentIDs": [
      "testing123"
    ],
    "layerIDs": [],
    "targetingGateID": ""
  }
}

Authorizations

​
STATSIG-API-KEY
string
header
required

Headers

​
x-respect-review-settings
string

Path Parameters

​
id
string
required

Body

application/json
​
isEnabled
boolean
required
Example:
​
description
string
required
Maximum length: 1000
Example:
​
passPercentage
number
required
Required range: 0 <= x <= 10
Example:
​
gateIDs
string[]
required
Example:
​
experimentIDs
string[]
required
Example:
​
layerIDs
string[]
required
Example:
​
isGlobal
boolean
required
Example:
​
targetingGateID
string | null
required
Example:
​
monitoringMetrics
object[]

Response

​
message
string
required
​
data
object
required