Create iteration (API Explorer) | LaunchDarkly

POST/api/v2/projects/projectKey/environments/environmentKey/experiments/experimentKey/iterations

Path Parameters

projectKeystringRequired
environmentKeystringRequired
experimentKeystringRequired

Body Parameters

hypothesisstringRequired
metricslist of objectsRequired(1 item)
- 1
  keystringRequired
treatmentslist of objectsRequired(1 item)
- 1
  namestringRequired
  baselinebooleanRequired
  allocationPercentstringRequired
  parameterslist of objectsRequired(1 item)
  1
  flagKeystringRequired
  variationIdstringRequired
flagsmap from strings to objectsRequired
- key
  value
  ruleIdstringRequired
  flagConfigVersionintegerRequired

Request

$ curl -X POST https://app.launchdarkly.com/api/v2/projects/projectKey/environments/environmentKey/experiments/experimentKey/iterations \
>      -H "Authorization: " \
>      -H "Content-Type: application/json" \
>      -d '{
>   "hypothesis": "Example hypothesis, the new button placement will increase conversion",
>   "metrics": [
>     {
>       "key": "metric-key-123abc"
>     }
>   ],
>   "treatments": [
>     {
>       "name": "Treatment 1",
>       "baseline": true,
>       "allocationPercent": "10",
>       "parameters": [
>         {
>           "flagKey": "example-flag-for-experiment",
>           "variationId": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
>         }
>       ]
>     }
>   ],
>   "flags": {
>     "key": {
>       "ruleId": "e432f62b-55f6-49dd-a02f-eb24acf39d05",
>       "flagConfigVersion": 12
>     }
>   }
> }'

Response

$	curl -X POST https://app.launchdarkly.com/api/v2/projects/projectKey/environments/environmentKey/experiments/experimentKey/iterations \
>	-H "Authorization: " \
>	-H "Content-Type: application/json" \
>	-d '{
>	"hypothesis": "Example hypothesis, the new button placement will increase conversion",
>	"metrics": [
>	{
>	"key": "metric-key-123abc"
>	}
>	],
>	"treatments": [
>	{
>	"name": "Treatment 1",
>	"baseline": true,
>	"allocationPercent": "10",
>	"parameters": [
>	{
>	"flagKey": "example-flag-for-experiment",
>	"variationId": "e432f62b-55f6-49dd-a02f-eb24acf39d05"
>	}
>	]
>	}
>	],
>	"flags": {
>	"key": {
>	"ruleId": "e432f62b-55f6-49dd-a02f-eb24acf39d05",
>	"flagConfigVersion": 12
>	}
>	}
>	}'