Gates

Update Gate Rules

Changed on Sep 25, 2026

Update all given rules. It does NOT create or delete if you add more rules and remove rules in the rules object.

patch/console/v1/gates/{id}/rules/{ruleID}

Request

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

Path parameters

idstring required

Gate ID

ruleIDstring required

Rule ID

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 name of this rule.

passPercentagenumber double

Of the users that meet the conditions of this rule, what percent should return true.

environmentsstring[] nullable

The environments this rule is enabled for.

idstring

The Statsig ID of this rule.

baseIDstring

The base ID of this rule, i.e. without any added metadata. Will remain the exact same throughout

returnValueobject

The return value of the rule.

Example request

{
  "name": "All Conditions",
  "id": "38ttpCpzrQFTMKcqFKk02l:10.00:1",
  "baseID": "38ttpCpzrQFTMKcqFKk02l",
  "passPercentage": 10,
  "conditions": [
    {
      "type": "user_id",
      "targetValue": [
        "35sClJFs8l0y5uRQhDwUDo"
      ],
      "operator": "any"
    }
  ],
  "environments": [
    "staging"
  ]
}

Response

Update gate response

messagestring required

A simple string explaining the result of the operation.

Example response

{
  "message": "Gate updated successfully.",
  "data": {
    "id": "a_gate",
    "isEnabled": true,
    "description": "helpful summary of what this gate does",
    "status": "In Progress",
    "lastModifierName": "CONSOLE API",
    "lastModifierID": "1vaasdfLlkaujjajiuOSBP2",
    "rules": [
      {
        "name": "All Conditions",
        "id": "38ttpCpzrQFTMKcqFKk02l:10.00:1",
        "baseID": "38ttpCpzrQFTMKcqFKk02l",
        "passPercentage": 10,
        "conditions": [
          {
            "type": "user_id",
            "targetValue": [
              "35sClJFs8l0y5uRQhDwUDo"
            ],
            "operator": "any"
          }
        ],
        "environments": [
          "staging"
        ]
      }
    ],
    "tags": [
      "* Core"
    ]
  }
}

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 (3 revisions)