Skip to main content
POST
/
console
/
v1
/
experiments
Create Experiment
curl --request POST \
  --url https://statsigapi.net/console/v1/experiments \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '{
  "name": "Test Experiment",
  "description": "Description test"
}'
{
  "message": "Experiment created successfully.",
  "data": {
    "id": "a_experiment",
    "name": "a_experiment",
    "description": "description",
    "idType": "userID",
    "lastModifierID": "1vaQaBoLlkauH9iiuOSBP2",
    "lastModifiedTime": 1707427635442,
    "lastModifierName": "CONSOLE API",
    "lastModifierEmail": null,
    "creatorID": "1vaQaBoLlkauH9iiuOSBP2",
    "createdTime": 1707427634717,
    "creatorName": "CONSOLE API",
    "creatorEmail": null,
    "targetApps": [],
    "holdoutIDs": [],
    "tags": [],
    "status": "setup",
    "experimentType": "BASE",
    "launchedGroupID": null,
    "startTime": null,
    "endTime": null,
    "layerID": null,
    "hypothesis": "This will be a good feature :)",
    "primaryMetrics": [
      {
        "name": "d1_retention_rate",
        "type": "user"
      }
    ],
    "primaryMetricTags": [],
    "secondaryMetrics": [],
    "secondaryMetricTags": [],
    "groups": [
      {
        "name": "Control",
        "id": "6sEQvUd4c6E55V6ljBYMeJ",
        "size": 50,
        "parameterValues": {
          "assigned_group": "control"
        },
        "description": ""
      },
      {
        "name": "Test",
        "id": "6sEQvVS6EoNzpkEgUJUpxL",
        "size": 50,
        "parameterValues": {
          "assigned_group": "test"
        },
        "description": ""
      }
    ],
    "allocation": 100,
    "duration": 14,
    "targetingGateID": "",
    "defaultConfidenceInterval": "95",
    "bonferroniCorrection": false,
    "decisionReason": null,
    "decisionTime": null,
    "healthChecks": [],
    "healthCheckStatus": "PASSED",
    "inlineTargetingRulesJSON": "{}"
  }
}

Authorizations

STATSIG-API-KEY
string
header
required

Headers

x-respect-review-settings
string

Body

application/json
name
string
required
Required string length: 3 - 100
description
string
Maximum length: 1000
idType
string
secondaryIDType
string | null
identifierMappingMode
enum<string>
Available options:
strictOneToOne,
firstTouchOneToMany,
lastTouchOneToMany
identityResolutionSource
string | null
hypothesis
string
groups
object[]
controlGroupID
string
allocation
number
Required range: 0 <= x <= 100
primaryMetricTags
string[]
secondaryMetricTags
string[]
primaryMetrics
object[]
secondaryMetrics
object[]
otherMetrics
object[]
targetApps
tags
string[]
duration
integer
Required range: x > 1
targetExposures
integer
Required range: x > 1
targetingGateID
string | null
sequentialTesting
boolean
bonferroniCorrection
boolean
bonferroniCorrectionPerMetric
boolean
benjaminiHochbergPerVariant
boolean
benjaminiHochbergPerMetric
boolean
benjaminiPrimaryMetricsOnly
boolean
defaultConfidenceInterval
enum<string>
Available options:
80,
90,
95,
98,
99
manualQualityScores
object[]
status
enum<string>
Available options:
active,
setup,
decision_made,
abandoned,
archived,
experiment_stopped,
assignment_stopped
launchedGroupID
string | null
assignmentSourceName
string
assignmentSourceExperimentName
string
creatorID
string | null
creatorEmail
string | null
isAnalysisOnly
boolean | null
team
string | null
teamID
string | null
allocationDuration
integer | null
Required range: x > 1
cohortedAnalysisDuration
integer
Required range: x > 1
cohortedMetricsMatureAfterEnd
boolean
cohortWaitUntilEndToInclude
boolean
fixedAnalysisDuration
integer
Required range: x > 1
scheduledReloadHour
integer | null
Required range: 0 <= x <= 23
scheduledReloadType
enum<string>
Available options:
full,
incremental
analysisEndTime
string
assignmentSourceFilters
object[]
analyticsType
enum<string>
Available options:
frequentist,
bayesian,
sprt
isSidecar
boolean
decisionReason
string
preComputedUserDimensions
object[]
cureCovariates
object[]
stratifiedSampling
object | null
id
string
Required string length: 3 - 100
layerID
string

Response

message
string
required
data
object
required