---
title: "Audit Overrides"
method: GET
path: "/console/v1/overrides"
tags: ["Overrides"]
---

# Audit Overrides

`GET /console/v1/overrides`

Returns overrides across all gates, holdouts, experiments, autotunes, and layers in the project. Provide `userId` (optionally with `idType`) to audit everywhere a single unit ID is overridden; omit it to export every override. Each section only lists entities that have matching overrides.

## Query parameters

- `userId` string
- `idType` string

## Response `200`

Audit Overrides Success

- object
  - `message` string, required — A simple string explaining the result of the operation.
  - `data` object, required — Overrides grouped by entity type. Each section only lists entities that have (matching) overrides.
    - `gates` object[], required — Feature gates with matching overrides.
      - `id` string, required — Entity identifier (name)
      - `name` string, required — Entity display name
      - `passingUserIDs` string[], required — List of user IDs
      - `failingUserIDs` string[], required — List of user IDs
      - `passingCustomIDs` string[] — Optional list of custom IDs
      - `failingCustomIDs` string[] — Optional list of custom IDs
      - `environmentOverrides` object[], required
        - `environment` string, nullable — Environment
        - `unitID` string, nullable, required — Unit ID
        - `passingIDs` string[], required — List of passing IDs
        - `failingIDs` string[], required — List of failing IDs
    - `holdouts` object[], required — Holdouts with matching overrides.
      - `id` string, required — Entity identifier (name)
      - `name` string, required — Entity display name
      - `passingUserIDs` string[], required — List of user IDs
      - `failingUserIDs` string[], required — List of user IDs
      - `passingCustomIDs` string[] — Optional list of custom IDs
      - `failingCustomIDs` string[] — Optional list of custom IDs
      - `environmentOverrides` object[], required
        - `environment` string, nullable — Environment
        - `unitID` string, nullable, required — Unit ID
        - `passingIDs` string[], required — List of passing IDs
        - `failingIDs` string[], required — List of failing IDs
    - `experiments` object[], required — Experiments with matching overrides.
      - `id` string, required — Entity identifier (name)
      - `name` string, required — Entity display name
      - `overrides` object[], required — Array of experiment overrides, each specifying type, ID, and group ID.
        - `type` 'gate' | 'segment', required
        - `id` string, required — The id of the segment or gate
        - `groupID` string, required — The experiment group which user will be forced into
        - `environment` string, nullable — Optional environment designation (e.g., production, staging) for the experiment.
      - `userIDOverrides` object[], required — Array of user ID overrides, specifying which users to force into experiment groups.
        - `groupID` string, required — The experiment group the user will be forced into.
        - `ids` string[], required — Array of user IDs to be assigned to the specified experiment group.
        - `environment` string, nullable — Optional environment designation (e.g., production, staging) for the experiment.
        - `unitType` string, nullable — Optional type of unit for the experiment, defining the scope of the override.
    - `autotunes` object[], required — Autotunes with matching overrides.
      - `id` string, required — Entity identifier (name)
      - `name` string, required — Entity display name
      - `overrides` object[], required — Array of experiment overrides, each specifying type, ID, and group ID.
        - `type` 'gate' | 'segment', required
        - `id` string, required — The id of the segment or gate
        - `groupID` string, required — The experiment group which user will be forced into
        - `environment` string, nullable — Optional environment designation (e.g., production, staging) for the experiment.
      - `userIDOverrides` object[], required — Array of user ID overrides, specifying which users to force into experiment groups.
        - `groupID` string, required — The experiment group the user will be forced into.
        - `ids` string[], required — Array of user IDs to be assigned to the specified experiment group.
        - `environment` string, nullable — Optional environment designation (e.g., production, staging) for the experiment.
        - `unitType` string, nullable — Optional type of unit for the experiment, defining the scope of the override.
    - `layers` object[], required — Layers with matching overrides.
      - `id` string, required — Entity identifier (name)
      - `name` string, required — Entity display name
      - `conditionalOverrides` object[], required
        - `type` string, required — Describes whether layer override is segment or gate
        - `name` string, required — Name of override entity
        - `experimentName` string, required
        - `groupName` string, required
        - `environment` string, nullable — Optional environment scope (e.g. production, staging). Omit or pass null to target the all-environments bucket.
      - `idOverrides` object[], required
        - `groupName` string, required — Group that ID is overriden into
        - `ids` string[], required — ID being overriden into a particular group
        - `idType` string, nullable
        - `environment` string, nullable
        - `experimentName` string, nullable

## Other responses

- `400` — Invalid request. Please check the request input and try again.
- `401` — This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx

---

[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/revisions/3189f450c93b/schema)