Amplitude · JSON Structure

Experiment Management Api Update Experiment Request Structure

UpdateExperimentRequest schema from Amplitude Experiment Management API

Type: object Properties: 5
A/B TestingAnalyticsExperimentationFeature FlagsProduct AnalyticsUser Behavior

UpdateExperimentRequest is a JSON Structure definition published by Amplitude, describing 5 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

name description enabled variants segments

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amplitude/refs/heads/main/json-structure/experiment-management-api-update-experiment-request-structure.json",
  "name": "UpdateExperimentRequest",
  "description": "UpdateExperimentRequest schema from Amplitude Experiment Management API",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The updated display name."
    },
    "description": {
      "type": "string",
      "description": "The updated description."
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether the experiment should be enabled."
    },
    "variants": {
      "type": "array",
      "description": "Updated variant configurations.",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The unique key for the variant."
          },
          "name": {
            "type": "string",
            "description": "The display name of the variant."
          },
          "payload": {
            "description": "An optional JSON payload associated with the variant."
          },
          "description": {
            "type": "string",
            "description": "A description of what this variant does."
          },
          "rolloutWeight": {
            "type": "int32",
            "description": "The rollout weight as a percentage (0-100) controlling traffic allocation to this variant.",
            "minimum": 0,
            "maximum": 100
          }
        }
      }
    },
    "segments": {
      "type": "array",
      "description": "Updated targeting segments.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The display name of the segment."
          },
          "conditions": {
            "type": "array",
            "description": "Array of targeting conditions that define this segment.",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "The condition type."
                },
                "prop": {
                  "type": "string",
                  "description": "The property to evaluate."
                },
                "op": {
                  "type": "string",
                  "description": "The comparison operator."
                },
                "values": {
                  "type": "array",
                  "description": "The values to compare against.",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "variant": {
            "type": "string",
            "description": "The variant key to assign when this segment matches."
          },
          "percentage": {
            "type": "int32",
            "description": "The percentage of matching users to include (0-100).",
            "minimum": 0,
            "maximum": 100
          }
        }
      }
    }
  }
}