---
title: "Delete holdout by id"
method: DELETE
path: "/console/v1/holdouts/{id}"
tags: ["Holdouts"]
---

# Delete holdout by id

`DELETE /console/v1/holdouts/{id}`

## Path parameters

- `id` string, required

## Response `200`

Delete holdout response

- object
  - `message` string, required — A simple string explaining the result of the operation.
  - `data` object, required — A single result.
    - `id` string, required — ID
    - `name` string — Optional name for the configuration.
    - `idType` string, required — type of id
    - `description` string, required — brief summary of what the holdout is being used for
    - `lastModifierID` string, nullable, required — ID of the last modifier.
    - `lastModifiedTime` number, double, nullable, required — Time of the last modification.
    - `lastModifierEmail` string, nullable, required — Email of the last modifier.
    - `lastModifierName` string, nullable, required — Name of the last modifier.
    - `creatorID` string, nullable, required — ID of the user who created the entity.
    - `createdTime` number, double, required — Timestamp when the entity was created.
    - `creatorName` string, nullable, required — Name of the creator.
    - `creatorEmail` string, nullable, required — Email of the creator.
    - `tags` string[] — Optional tags for categorization.
    - `targetApps` string[] — List of target applications associated with this configuration.
    - `holdoutIDs` string[] — Holdouts applied to this configuration.
    - `team` string, nullable — Optional name for the responsible team.
    - `teamID` string, nullable — Optional ID of the responsible team.
    - `version` number, double — Version number
    - `permalink` string, uri, required — A permalink to this holdout in the Statsig Console.
    - `isEnabled` boolean, required — enable or disable the holdout
    - `passPercentage` number, double, required — percentage of users between 0-10% to pass through the holdout
    - `gateIDs` string[], required — an array of gate IDs which this holdout is applied to
    - `experimentIDs` string[], required — an array of experiment IDs which this holdout is applied to
    - `layerIDs` string[], required — an array of layer IDs which this holdout is applied to
    - `isGlobal` boolean, required — whether the holdout is being applied to all new gates
    - `targetingGateID` string, nullable, required — the internal ID of the gate that the holdout is targeting; null or empty when unset
    - `monitoringMetrics` object[]
      - `name` string, required
      - `type` string, required

## Other responses

- `401` — This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx
- `404` — Holdout not found.

---

[API](https://skmtc.net/statsig/apis/console-api.md) · [All operations](https://skmtc.net/statsig/apis/console-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/statsig/console-api/versions/3189f450c93b/schema)