Partially update experiment
PATCH/experiments/:experimentId
Update several fields of an experiment
Request
Path Parameters
Query Parameters
Possible values: [ACTIVATE
, PAUSE
, RESUME
, STOP
, SCHEDULE
, DEACTIVATE
]
Action to change the status of experiment
- application/json
Body
Array [
]
Deprecated. Use trafficAllocationMethod field instead
URL of the website to load in the editor and preview mode
CSS code specific to all variations
JavaScript code specific to all variations
Description of the experiment
deviations
object
Traffic allocation per variation. Key can be 'origin' (for original page) or variation Id. Value
is the percentage of traffic which will be allocated to this variation. It has to be double numbers ranging from 0(0%) to 1(100%).
Traffic allocation per variation. Key can be 'origin' (for original page) or variation Id. Value
is the percentage of traffic which will be allocated to this variation. It has to be double numbers ranging from 0(0%) to 1(100%).
JavaScript code that will be executed only for the selected experiment at the end of the Global custom script.
Goal Id(s) associated with this experiment
Indicates whether multiple testing correction is enabled
Main goal Id of the experiment
Name of the experiment
respoolTime
object
The respoolTime
map contains key-value pairs where each key is a variation ID and the corresponding value is a timestamp that represents the most recent change to the variation allocation, such as through the Kameleoon app or the Automation API.
The respoolTime
map contains key-value pairs where each key is a variation ID and the corresponding value is a timestamp that represents the most recent change to the variation allocation, such as through the Kameleoon app or the Automation API.
Tags associated with this experiment
Possible values: [GRAPHICAL_PAGES
, HEAT_SLICE
, PAGE
, SAVED_TEMPLATE
, SITE
, URL
]
Id of the segment you want to target in this experiment
trackingTools
object[]
Tracking tools you want use in this experiment
Possible values: [GOOGLE_ANALYTICS4
, GOOGLE_ANALYTICS4_AUDIENCES
, GOOGLE_UNIVERSAL_ANALYTICS
, ECONDA
, SMART_TAG
, PIANO
, ADOBE_OMNITURE
, EULERIAN
, WEBTRENDS
, KISSMETRICS
, PIWIK
, CRAZY_EGG
, COM_SCORE
, TEALIUM
, YSANCE
, M_PATHY
, SMARTFOCUS
, EMARSYS
, EXPERTSENDER
, TAG_COMMANDER
, CONTENT_SQUARE
, WEBTREKK
, CUSTOM_INTEGRATIONS
, HEAP
, SEGMENT
, MIXPANEL
, CLARITY
, IABTCF
, DATABRICKS
, REDSHIFT
, SMARTLOOK
, MOUSEFLOW
, KLAVIYO
, FULLSTORY
, AMPLITUDE
, SNOWPLOW
, JUNE
, MPARTICLE
, BIGQUERY
, RUDDERSTACK
, SNOWFLAKE
, GLASSBOX
, HUBSPOT
, AIR360
, DATADOG
, QUANTUM_METRIC
, KAMELEOON_TRACKING
, CUSTOM_TRACKING
, VERCEL
, AKAMAI
]
Possible values: [CONTEXTUAL_BANDIT
, MANUAL
, MULTI_ARMED_BANDIT
]
Responses
- 200
- 400
- 401
- 403
- 404
- 423
- 500
OK
- */*
- Schema
- Example (from schema)
Schema
Array [
]
Array [
]
Array [
]
Deprecated. Use trafficAllocationMethod field instead
URL of the website to load in editor and preview mode
CSS code specific to all variations
JavaScript code specific to all variations
Account id of the creator of the experiment
Date the data collection stops
deviations
object
Traffic allocation per variation. Key can be 'origin'(for original page) or variation id.Value
is the percentage of traffic which will be directed to this variation.It has to be double numbers ranging from 0(0%) to 1(100%).
Traffic allocation per variation. Key can be 'origin'(for original page) or variation id.Value
is the percentage of traffic which will be directed to this variation.It has to be double numbers ranging from 0(0%) to 1(100%).
JavaScript code that will be applied only to the selected experiment and executed in the end of the Global custom script
List of goal ids being used by this experiment.For GET requests, this is an optional field that needs to be specified in request params
Sytem-generated unique ID associated with the experiment
Indicates whether multiple testing correction is enabled
mvtAllocationSettings
object
combinationsAllocations
object[]
sectionsAllocations
object[]
Name of the experiment
respoolTime
object
The respoolTime map contains key-value pairs, where each key is a variation ID and the corresponding value is a timestamp representing the most recent change to the variation’s allocation (for example, using the Kameleoon app or the Automation API).
The respoolTime map contains key-value pairs, where each key is a variation ID and the corresponding value is a timestamp representing the most recent change to the variation’s allocation (for example, using the Kameleoon app or the Automation API).
Site code of the experiment
ID of the website that the experiment belongs to
The status of the given experiment
List of tags being used by this experiment.For GET requests, this is an optional field that needs to be specified in request params.
Possible values: [GRAPHICAL_PAGES
, HEAT_SLICE
, PAGE
, SAVED_TEMPLATE
, SITE
, URL
]
trackingTools
object[]
Possible values: [GOOGLE_ANALYTICS4
, GOOGLE_ANALYTICS4_AUDIENCES
, GOOGLE_UNIVERSAL_ANALYTICS
, ECONDA
, SMART_TAG
, PIANO
, ADOBE_OMNITURE
, EULERIAN
, WEBTRENDS
, KISSMETRICS
, PIWIK
, CRAZY_EGG
, COM_SCORE
, TEALIUM
, YSANCE
, M_PATHY
, SMARTFOCUS
, EMARSYS
, EXPERTSENDER
, TAG_COMMANDER
, CONTENT_SQUARE
, WEBTREKK
, CUSTOM_INTEGRATIONS
, HEAP
, SEGMENT
, MIXPANEL
, CLARITY
, IABTCF
, DATABRICKS
, REDSHIFT
, SMARTLOOK
, MOUSEFLOW
, KLAVIYO
, FULLSTORY
, AMPLITUDE
, SNOWPLOW
, JUNE
, MPARTICLE
, BIGQUERY
, RUDDERSTACK
, SNOWFLAKE
, GLASSBOX
, HUBSPOT
, AIR360
, DATADOG
, QUANTUM_METRIC
, KAMELEOON_TRACKING
, CUSTOM_TRACKING
, VERCEL
, AKAMAI
]
Possible values: [CONTEXTUAL_BANDIT
, MANUAL
, MULTI_ARMED_BANDIT
]
Possible values: [AI
, CLASSIC
, DEVELOPER
, FEATURE_FLAG
, MVT
, SDK_HYBRID
]
List of variation ids for this experiment
{
"baseURL": "string",
"collectingDataEnabled": true,
"commonCssCode": "string",
"commonJavaScriptCode": "string",
"createdBy": 0,
"dateCollectingDataStopped": "2024-07-29T15:51:28.071Z",
"dateCreated": "2024-07-29T15:51:28.071Z",
"dateEnded": "2024-07-29T15:51:28.071Z",
"dateModified": "2024-07-29T15:51:28.071Z",
"dateStarted": "2024-07-29T15:51:28.071Z",
"dateStatusModified": "2024-07-29T15:51:28.071Z",
"description": "string",
"deviations": {
"12345": 0.5,
"origin": 0.5
},
"executeCodeForReference": true,
"globalScript": "string",
"goals": [
0
],
"id": 0,
"isArchived": true,
"isLegacyEditor": true,
"isMultipleTestingCorrection": true,
"mainGoalId": 0,
"mvtAllocationSettings": {
"combinationsAllocations": [
{
"allocationPart": 0,
"checked": true,
"locked": true,
"sectionId": 0,
"variationId": "string"
}
],
"exposedPart": 0,
"sectionsAllocations": [
{
"allocationPart": 0,
"checked": true,
"locked": true,
"sectionId": 0,
"variationId": "string"
}
]
},
"name": "string",
"respoolTime": {
"12345": 833760000,
"origin": 1704067200
},
"siteCode": "string",
"siteId": 0,
"status": "string",
"tags": [
"string"
],
"targetingConfiguration": "GRAPHICAL_PAGES",
"targetingSegmentId": 0,
"trackingTools": [
{
"adobeOmnitureObject": "string",
"comScoreCustomerId": "string",
"comScoreDomain": "string",
"contentSquareUrl": "string",
"customIntegrations": [
"string"
],
"customVariable": 0,
"eulerianUserCentricParameter": "string",
"name": "GOOGLE_ANALYTICS4",
"reportingScript": "string",
"universalAnalyticsDimension": 0
}
],
"trafficAllocationMethod": "CONTEXTUAL_BANDIT",
"type": "AI",
"variations": [
0
]
}
Bad Request
- */*
- Schema
- Example (from schema)
Schema
Possible values: [SUCCESS
, ERROR
]
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-07-29T15:51:28.071Z"
}
Unauthorized
- */*
- Schema
- Example (from schema)
Schema
Possible values: [SUCCESS
, ERROR
]
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-07-29T15:51:28.071Z"
}
Forbidden
- */*
- Schema
- Example (from schema)
Schema
Possible values: [SUCCESS
, ERROR
]
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-07-29T15:51:28.071Z"
}
Not Found
- */*
- Schema
- Example (from schema)
Schema
Possible values: [SUCCESS
, ERROR
]
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-07-29T15:51:28.071Z"
}
Locked
- */*
- Schema
- Example (from schema)
Schema
Possible values: [SUCCESS
, ERROR
]
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-07-29T15:51:28.071Z"
}
Internal Server Error
- */*
- Schema
- Example (from schema)
Schema
Possible values: [SUCCESS
, ERROR
]
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-07-29T15:51:28.071Z"
}