Gates

Fully Update Gates

Changed on Sep 25, 2026

post/console/v1/gates/{id}

Request

Base URL
https://statsigapi.net
URL
https://statsigapi.net/console/v1/gates/{id}
Auth
API key in header STATSIG-API-KEY

Path parameters

idstring required

Query parameters

includeArchiveMetadata'true' | 'false'

When "true", populate archivedAt / archivedBy* / archiveReason on the gate when it is currently archived. When omitted or "false", those fields are absent from the response.

Request body

namestring

The gate display name

isEnabledboolean required

descriptionstring required

tagsstring[]

type'PERMANENT' | 'TEMPORARY'

idTypestring

creatorIDstring nullable

creatorEmailstring nullable

teamstring nullable

teamIDstring nullable

measureMetricLiftsboolean

releasePipelineIDstring nullable

Example request

{
  "isEnabled": false,
  "description": "Updated Gate Description",
  "rules": [
    {
      "name": "All Conditions",
      "passPercentage": 10,
      "conditions": [
        {
          "type": "user_id",
          "targetValue": [
            "111",
            "222"
          ],
          "operator": "any"
        },
        {
          "type": "email",
          "targetValue": [
            "@outlook.com",
            "@gmail.com"
          ],
          "operator": "str_contains_any"
        },
        {
          "type": "custom_field",
          "targetValue": 31,
          "operator": "gt",
          "field": "age"
        },
        {
          "type": "app_version",
          "targetValue": "1.1.1",
          "operator": "version_gt"
        },
        {
          "type": "browser_name",
          "targetValue": [
            "Android",
            "Chrome"
          ],
          "operator": "any"
        },
        {
          "type": "browser_version",
          "targetValue": [
            "94.0.4606.81",
            "94.0.4606.92"
          ],
          "operator": "any"
        },
        {
          "type": "os_name",
          "targetValue": [
            "Android",
            "Windows"
          ],
          "operator": "none"
        },
        {
          "type": "os_version",
          "targetValue": "11.0.0",
          "operator": "version_lte"
        },
        {
          "type": "country",
          "targetValue": [
            "NZ",
            "US"
          ],
          "operator": "any"
        },
        {
          "type": "environment_tier",
          "targetValue": [
            "production"
          ],
          "operator": "any"
        },
        {
          "type": "passes_segment",
          "targetValue": "growth_org"
        },
        {
          "type": "fails_segment",
          "targetValue": "growth_org"
        },
        {
          "type": "ip_address",
          "targetValue": [
            "1.1.1.1",
            "8.8.8.8"
          ],
          "operator": "any"
        },
        {
          "type": "unit_id",
          "operator": "any",
          "targetValue": [
            "31"
          ],
          "customID": "userID"
        }
      ]
    }
  ],
  "tags": [
    "★ Core"
  ],
  "type": "TEMPORARY",
  "idType": "stableID",
  "targetApps": []
}

Response

Update gate response

messagestring required

A simple string explaining the result of the operation.

Example response

{
  "data": {
    "checksPerHour": 0,
    "createdTime": 1705439406615,
    "creatorEmail": null,
    "creatorID": "4R5PV7mvYdW6NLCwK8ocoz",
    "creatorName": "CONSOLE API",
    "description": "Updated Gate Description",
    "holdoutIDs": [],
    "id": "a_gate",
    "idType": "stableID",
    "isEnabled": false,
    "lastModifiedTime": 1705439409750,
    "lastModifierEmail": null,
    "lastModifierID": "4R5PV7mvYdW6NLCwK8ocoz",
    "lastModifierName": "CONSOLE API",
    "name": "A Gate",
    "rules": [
      {
        "conditions": [
          {
            "operator": "any",
            "targetValue": [
              "111",
              "222"
            ],
            "type": "user_id"
          },
          {
            "operator": "str_contains_any",
            "targetValue": [
              "@outlook.com",
              "@gmail.com"
            ],
            "type": "email"
          },
          {
            "field": "age",
            "operator": "gt",
            "targetValue": 31,
            "type": "custom_field"
          },
          {
            "operator": "version_gt",
            "targetValue": "1.1.1",
            "type": "app_version"
          },
          {
            "operator": "any",
            "targetValue": [
              "Android",
              "Chrome"
            ],
            "type": "browser_name"
          },
          {
            "operator": "any",
            "targetValue": [
              "94.0.4606.81",
              "94.0.4606.92"
            ],
            "type": "browser_version"
          },
          {
            "operator": "none",
            "targetValue": [
              "Android",
              "Windows"
            ],
            "type": "os_name"
          },
          {
            "operator": "version_lte",
            "targetValue": "11.0.0",
            "type": "os_version"
          },
          {
            "operator": "any",
            "targetValue": [
              "NZ",
              "US"
            ],
            "type": "country"
          },
          {
            "operator": "any",
            "targetValue": [
              "production"
            ],
            "type": "environment_tier"
          },
          {
            "targetValue": "growth_org",
            "type": "passes_segment"
          },
          {
            "targetValue": "growth_org",
            "type": "fails_segment"
          },
          {
            "operator": "any",
            "targetValue": [
              "1.1.1.1",
              "8.8.8.8"
            ],
            "type": "ip_address"
          },
          {
            "customID": "userID",
            "operator": "any",
            "targetValue": [
              "31"
            ],
            "type": "unit_id"
          }
        ],
        "environments": null,
        "name": "All Conditions",
        "passPercentage": 10
      }
    ],
    "status": "Disabled",
    "tags": [
      "★ Core"
    ],
    "targetApps": [],
    "type": "PERMANENT",
    "typeReason": "NONE",
    "team": null,
    "reviewSettings": {
      "requiredReview": false,
      "allowedReviewers": []
    },
    "measureMetricLifts": true,
    "store0100Exposures": false,
    "owner": {
      "ownerID": "user123",
      "ownerName": "CONSOLE API",
      "ownerType": "SDK_KEY",
      "ownerEmail": ""
    },
    "monitoringMetrics": [],
    "version": 2,
    "permalink": "https://console.statsig.com/company_id/gates/a_gate"
  },
  "message": "Gate updated successfully."
}

Changes

Sep 25, 202623753feb4120 Revision changes
- info
  added the new optional request property ////
- info
  added the new optional request property ////
- info
  added the new optional request property //
- info
  the request optional property // became not read-only
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  the response optional property //// became not read-only for the status
Aug 26, 20261fd471fa03cc Revision changes
- breaking
  request property //// was restricted to a list of enum values
- warning
  added the new after enum value to the ////// response property for the response status
- warning
  added the new any enum value to the ////// response property for the response status
- warning
  added the new any_case_sensitive enum value to the ////// response property for the response status
- warning
  added the new array_contains_all enum value to the ////// response property for the response status
- warning
  added the new array_contains_any enum value to the ////// response property for the response status
- warning
  added the new array_contains_none enum value to the ////// response property for the response status
- warning
  added the new before enum value to the ////// response property for the response status
- warning
  added the new encoded_any enum value to the ////// response property for the response status
- warning
  added the new gt enum value to the ////// response property for the response status
- warning
  added the new gte enum value to the ////// response property for the response status
- warning
  added the new is_not_null enum value to the ////// response property for the response status
- warning
  added the new is_null enum value to the ////// response property for the response status
- warning
  added the new lt enum value to the ////// response property for the response status
- warning
  added the new lte enum value to the ////// response property for the response status
- warning
  added the new none enum value to the ////// response property for the response status
- warning
  added the new none_case_sensitive enum value to the ////// response property for the response status
- warning
  added the new not_array_contains_all enum value to the ////// response property for the response status
- warning
  added the new on enum value to the ////// response property for the response status
- warning
  added the new str_contains_any enum value to the ////// response property for the response status
- warning
  added the new str_contains_none enum value to the ////// response property for the response status
- warning
  added the new str_matches enum value to the ////// response property for the response status
- warning
  added the new version_eq enum value to the ////// response property for the response status
- warning
  added the new version_gt enum value to the ////// response property for the response status
- warning
  added the new version_gte enum value to the ////// response property for the response status
- warning
  added the new version_lt enum value to the ////// response property for the response status
- warning
  added the new version_lte enum value to the ////// response property for the response status
- info
  added the new after enum value to the request property ////
- info
  added the new any enum value to the request property ////
- info
  added the new any_case_sensitive enum value to the request property ////
- info
  added the new array_contains_all enum value to the request property ////
- info
  added the new array_contains_any enum value to the request property ////
- info
  added the new array_contains_none enum value to the request property ////
- info
  added the new before enum value to the request property ////
- info
  added the new encoded_any enum value to the request property ////
- info
  added the new gt enum value to the request property ////
- info
  added the new gte enum value to the request property ////
- info
  added the new is_not_null enum value to the request property ////
- info
  added the new is_null enum value to the request property ////
- info
  added the new lt enum value to the request property ////
- info
  added the new lte enum value to the request property ////
- info
  added the new none enum value to the request property ////
- info
  added the new none_case_sensitive enum value to the request property ////
- info
  added the new not_array_contains_all enum value to the request property ////
- info
  added the new on enum value to the request property ////
- info
  added the new str_contains_any enum value to the request property ////
- info
  added the new str_contains_none enum value to the request property ////
- info
  added the new str_matches enum value to the request property ////
- info
  added the new version_eq enum value to the request property ////
- info
  added the new version_gt enum value to the request property ////
- info
  added the new version_gte enum value to the request property ////
- info
  added the new version_lt enum value to the request property ////
- info
  added the new version_lte enum value to the request property ////

Operation history (4 revisions)