Statsig

statsig Holdouts API

Manage holdout groups that exclude users from receiving specific features for measuring long-term impact.

GitHub OpenAPI

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /holdouts List holdout groups · List all holdouts #
Ask an LLM
“Which holdout groups are set up in my Statsig project?”
“What holdouts are we using to measure long-term impact?”
Tell an agent
List all holdouts in my project.
Show me every holdout group we have.
POST /holdouts Create a holdout group · Create a holdout #
Ask an LLM
“How do I hold back a group of users to measure the long-term impact of features?”
“Can a holdout cover specific feature gates?”
Tell an agent
Create a holdout named {name}.
Create holdout {name} holding back {passPercentage} percent of users from gates {gateIDs}.
GET /console/v1/holdouts Filter and page through holdouts · List Holdouts #
Ask an LLM
“Can I filter holdouts by who created them or by tag?”
“Which holdouts carry a particular tag?”
Tell an agent
List holdouts created by {creatorName}.
Find holdouts tagged {tags}, page {page} with {limit} per page.
POST /console/v1/holdouts Create a holdout for a team and unit type · Create holdout #
Ask an LLM
“Can I create a holdout keyed on a custom unit ID type instead of user ID?”
“Is it possible to assign a new holdout to a specific team when I create it?”
Tell an agent
Create holdout {name} for team {teamID}.
Set up a holdout called {name} using unit type {idType}, described as {description}.
GET /console/v1/holdouts/{id} Get one holdout's details · Get holdout by id #
Ask an LLM
“What gates and experiments does a given holdout apply to?”
“What pass percentage is a specific holdout using right now?”
Tell an agent
Show me the details of holdout {id}.
Look up holdout {id} and tell me whether it is enabled.
POST /console/v1/holdouts/{id} Replace a holdout's full configuration · Update holdout by id #
Ask an LLM
“How do I overwrite every setting on a holdout in one request?”
“Must I send all holdout fields when doing a full update?”
Tell an agent
Fully replace holdout {id}: enabled {isEnabled}, pass {passPercentage} percent, gates {gateIDs}, experiments {experimentIDs}, layers {layerIDs}.
Rewrite holdout {id} as global {isGlobal}, targeting gate {targetingGateID}, with description {description}.
PATCH /console/v1/holdouts/{id} Change selected holdout settings · Partially update holdout by id #
Ask an LLM
“Can I change just the pass percentage on a holdout without resending everything?”
“Is there a way to switch a holdout off and leave its other settings alone?”
Tell an agent
Set the pass percentage on holdout {id} to {passPercentage}.
Disable holdout {id} by setting enabled to {isEnabled}.
DELETE /console/v1/holdouts/{id} Delete a holdout · Delete holdout by id #
Ask an LLM
“Can I permanently remove a holdout we no longer need?”
“What happens to a holdout once I delete it?”
Tell an agent destructive · confirm first
Delete holdout {id}.
Remove the holdout with ID {id} from the project for good.
GET /console/v1/holdouts/{id}/overrides View a holdout's overrides · Read Holdout Overrides #
Ask an LLM
“Which IDs are forced into or out of a holdout?”
“Are there manual overrides on this holdout?”
Tell an agent
Show the overrides on holdout {id}.
List which unit IDs are overridden in holdout {id}.
POST /console/v1/holdouts/{id}/overrides Replace a holdout's override list · Update Holdout Overrides #
Ask an LLM
“How do I reset the whole override list on a holdout?”
“Can I swap out every holdout override in a single call?”
Tell an agent
Replace all overrides on holdout {id} with a new set.
Overwrite the override list for holdout {id}.
PATCH /console/v1/holdouts/{id}/overrides Add IDs to a holdout's overrides · Add Holdout Overrides #
Ask an LLM
“Can I append more IDs to a holdout's overrides without replacing the existing ones?”
“Is it possible to force an extra user into a holdout?”
Tell an agent
Add these IDs to the overrides on holdout {id}.
Append new override entries to holdout {id}, keeping the existing ones.
DELETE /console/v1/holdouts/{id}/overrides Remove IDs from a holdout's overrides · Remove Holdout Overrides #
Ask an LLM
“Can I take specific IDs off a holdout's override list?”
“What's the way to drop a few overridden users from a holdout?”
Tell an agent destructive · confirm first
Remove selected IDs from the overrides on holdout {id}.
Drop these users from holdout {id}'s override list.
GET /console/v1/holdouts/{id}/pulse_results Get a holdout's Pulse results · Retrieve Pulse Results #
Ask an LLM
“What is the long-term impact measured by a holdout so far?”
“Can I read holdout Pulse results with CUPED variance reduction applied?”
Tell an agent
Get the Pulse results for holdout {id}.
Show Pulse results for holdout {id} with CUPED {cuped} at {confidence} percent confidence.

Documentation

📖
Documentation
https://docs.statsig.com/http-api/
📖
Documentation
https://docs.statsig.com/console-api/
📖
Documentation
https://docs.statsig.com/client/introduction
📖
Documentation
https://docs.statsig.com/server/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/statsig/refs/heads/main/openapi/statsig-holdouts-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/statsig:statsig-holdouts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

statsig-holdouts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Statsig Holdouts API
  version: '1.0'
  description: 'Operations tagged Holdouts across 2 of this provider''s published API definitions: statsig-console-api-openapi.yml, statsig-holdouts-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://statsigapi.net/console/v1
  description: Statsig Console API Server
- url: https://statsigapi.net
tags:


# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/statsig/refs/heads/main/openapi/statsig-holdouts-api-openapi.yml