Experiment

June 9, 2026 ยท View on GitHub

Example Usage

import { Experiment } from "@vercel/sdk/models/flag.js";

let value: Experiment = {
  allocationUnit: "visitorId",
  primaryMetrics: [
    {
      name: "<value>",
      metricType: "percentage",
      metricUnit: "user",
      directionality: "decreaseIsGood",
    },
  ],
  status: "draft",
};

Fields

FieldTypeRequiredDescription
idstring:heavy_minus_sign:N/A
namestring:heavy_minus_sign:N/A
numVariantsnumber:heavy_minus_sign:N/A
surfaceAreastring:heavy_minus_sign:N/A
stickyRequirementboolean:heavy_minus_sign:N/A
layerstring:heavy_minus_sign:N/A
guardrailMetricsmodels.GuardrailMetrics[]:heavy_minus_sign:N/A
hypothesisstring:heavy_minus_sign:N/A
devicemodels.Device:heavy_minus_sign:N/A
controlVariantIdstring:heavy_minus_sign:N/A
startedAtnumber:heavy_minus_sign:N/A
endedAtnumber:heavy_minus_sign:N/A
decisionstring:heavy_minus_sign:N/A
decisionReasonstring:heavy_minus_sign:N/A
durationnumber:heavy_minus_sign:N/A
durationUnitmodels.DurationUnit:heavy_minus_sign:N/A
allocationPercentnumber:heavy_minus_sign:N/A
allocationUnitmodels.AllocationUnit:heavy_check_mark:N/A
primaryMetricsmodels.PrimaryMetrics[]:heavy_check_mark:N/A
statusmodels.FlagStatus:heavy_check_mark:N/A