Dynamic Configs

Fully Update Dynamic Config

Changed on Sep 25, 2026

post/console/v1/dynamic_configs/{id}

Request

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

Path parameters

idstring required

Query parameters

dryRunboolean

Example:true

Skips persisting updates to the entity (used to validate that inputs are correct)

Request body

namestring

Optional name for the configuration.

isEnabledboolean required

Is the dynamic config enabled

descriptionstring required

A brief summary of what the dynamic config is being used for

defaultValueobject

The fallback JSON object when no rules are triggered

defaultValueJson5string

Can include comments. If provided with defaultValue, must parse to the same JSON

idTypestring

The type of ID which the dynamic config is based on.

tagsstring[]

The list of tag names attached to the dynamic config

creatorIDstring nullable

creatorEmailstring nullable

schemastring nullable

A schema using JSON Schema Draft 2020-12 to enforce return values of this dynamic config's rules.

schemaJson5string nullable

schema except with Json5 comments. Optional and should parse to same json as schema.

teamstring nullable

The team name associated with the dynamic config, Enterprise only.

teamIDstring nullable

The team ID associated with the dynamic config, Enterprise only.

releasePipelineIDstring nullable

The release pipeline ID associated with the dynamic config

type'PERMANENT' | 'TEMPORARY'

Set to PERMANENT to mark this config as long-lived, or TEMPORARY to unmark it. Only honored on the update endpoints; this field is ignored when creating a config.

Example request

{
  "name": "my_config",
  "description": "helpful summary of what this dynamic config does",
  "idType": "userID",
  "tags": [
    "a tag"
  ],
  "owner": {
    "ownerID": "user123",
    "ownerType": "USER",
    "ownerName": "John Doe",
    "ownerEmail": "owner123@test.com"
  }
}

Response

Fully Update Dynamic Config Response

messagestring required

A simple string explaining the result of the operation.

Example response

{
  "message": "Dynamic config updated successfully.",
  "data": {
    "id": "a_dynamic_config",
    "permalink": "https://console.statsig.com/company_id/dynamic_configs/a_dynamic_config",
    "description": "helpful summary of what this dynamic config does",
    "idType": "userID",
    "creatorEmail": "johnsmith@mydomain.com",
    "creatorName": "John Smith",
    "createdTime": 1674769467002,
    "lastModifierID": "1vaQaBoLlkauH9iiuOSBP2",
    "lastModifierName": "CONSOLE API",
    "lastModifiedTime": 1707344887865,
    "lastModifierEmail": null,
    "holdoutIDs": [],
    "isEnabled": true,
    "rules": [
      {
        "name": "All Conditions",
        "id": "38ttpCpzrQFTMKcqFKk02l:10.00:1",
        "baseID": "38ttpCpzrQFTMKcqFKk02l",
        "passPercentage": 10,
        "conditions": [
          {
            "type": "public",
            "operator": "any",
            "targetValue": 0,
            "field": "string",
            "customID": "string"
          }
        ],
        "returnValue": {
          "key": true
        },
        "completedAutomatedRollouts": [],
        "pendingAutomatedRollouts": []
      }
    ],
    "defaultValue": {
      "key": "the default value"
    },
    "tags": [
      "a tag"
    ],
    "type": "TEMPORARY",
    "typeReason": "NONE",
    "isPermanent": false
  }
}

Changes

Sep 25, 202623753feb4120 Revision changes
- info
  added the new optional request property ////
- 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)