Create a new feature flag configuration
Create new feature flag configurations with given parameters
- application/json
Request Body required
- description string
Description of the feature
environmentConfigurations object[]
Environment-specific configurations for the feature flag
Array [defaultVariationKey string requiredPossible values:
<= 255 characters
Default variation key to serve in this environment
environmentKey string requiredEnvironment key associated with this configuration
featureEnabled boolean requiredIndicates whether the feature flag is enabled in this environment
integrations object
Integrations associated with the feature flag environment
deliveryRules object[]
List of integrations enabled for delivery rules
Array [customAnalytics string[]Name of the custom analytics
customVariable int32Integration custom variable
integrationName stringPossible 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
,REDSHIFT
,SMARTLOOK
,MOUSEFLOW
,KLAVIYO
,FULLSTORY
,AMPLITUDE
,SNOWPLOW
,JUNE
,MPARTICLE
,BIGQUERY
,RUDDERSTACK
,SNOWFLAKE
,GLASSBOX
,HUBSPOT
,AIR360
,DATADOG
,QUANTUM_METRIC
,KAMELEOON_TRACKING
,CUSTOM_TRACKING
,VERCEL
,AKAMAI
]Name of the integration
]experimentRules object[]
List of integrations enabled for experimentation rules
Array [customAnalytics string[]Name of the custom analytics
customVariable int32Integration custom variable
integrationName stringPossible 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
,REDSHIFT
,SMARTLOOK
,MOUSEFLOW
,KLAVIYO
,FULLSTORY
,AMPLITUDE
,SNOWPLOW
,JUNE
,MPARTICLE
,BIGQUERY
,RUDDERSTACK
,SNOWFLAKE
,GLASSBOX
,HUBSPOT
,AIR360
,DATADOG
,QUANTUM_METRIC
,KAMELEOON_TRACKING
,CUSTOM_TRACKING
,VERCEL
,AKAMAI
]Name of the integration
]rolloutRules object[]
Rollout rules for this environment
Array [- oneOf
- FeatureRolloutExperimentationRule
- FeatureRolloutProgressiveRule
- FeatureRolloutTargetedRule
controlVariationKey stringexposition int32Possible values:
<= 100
Percentage of the traffic exposed to this rule
multiArmedBandit booleanEnable dynamic allocation for this rule (Multi-Armed Bandit)
name stringName of the rule
reallocation booleanPerform traffic reallocation
release object
Release date information about this rule
releaseFrom date-timeRule being applied from this date
releaseTo date-timeRule being applied to this date
timeZone stringTimezone regarding the release of this rule
rollbackConditions object[]
Conditions for defining rollback
Array [comparisonOperator string requiredPossible values: [
GREATER_THAN
,LESS_THAN
]The rollback condition comparison operator
criteria string requiredPossible values: [
UPLIFT
,DOWNLIFT
,CONVERSION_RATE
]The rollback condition criteria
goalId int64 requiredThe rollback condition goal ID
matchValue double requiredThe rollback condition match value
recipients string[]List of emails of recipients who will be notified when conditions are triggered
target string requiredPossible values: [
RULE
,ENVIRONMENT
]The rollback condition target
visitors int32 requiredThe rollback condition visitors
]segmentId int64ID of the segment targeted by this rule
state stringPossible values: [
ACTIVE
,PAUSED
]Wished state of the rule
status stringPossible values: [
ACTIVE
,PAUSED
,PLANNED
,OUTDATED
]Status of the rule
trafficAllocations object[]
Traffic allocation settings for the rule
Array [exposition double requiredPossible values:
<= 100
Percentage of the traffic allocated to this variation
variationId int64Internally generated ID of the variation
variationKey string requiredPossible values:
<= 255 characters
Key of the variation
]name stringName of the rule
reallocation booleanPerform traffic reallocation
release object
Release date information about this rule
releaseFrom date-timeRule being applied from this date
releaseTo date-timeRule being applied to this date
timeZone stringTimezone regarding the release of this rule
rollbackConditions object[]
Conditions for defining rollback
Array [comparisonOperator string requiredPossible values: [
GREATER_THAN
,LESS_THAN
]The rollback condition comparison operator
criteria string requiredPossible values: [
UPLIFT
,DOWNLIFT
,CONVERSION_RATE
]The rollback condition criteria
goalId int64 requiredThe rollback condition goal ID
matchValue double requiredThe rollback condition match value
recipients string[]List of emails of recipients who will be notified when conditions are triggered
target string requiredPossible values: [
RULE
,ENVIRONMENT
]The rollback condition target
visitors int32 requiredThe rollback condition visitors
]rolloutConfiguration object
- oneOf
- CustomRampUpRollout
- ProgressiveExposure
steps object[] required
List of rollout steps
Array [dateTime date-timeDate time of the step
exposure floatExposure of the step
]frequency object
Frequency at which the exposition will evolve
unit string requiredPossible values: [
Nanos
,Micros
,Millis
,Seconds
,Minutes
,Hours
,HalfDays
,Days
,Weeks
,Months
,Years
,Decades
,Centuries
,Millennia
,Eras
,Forever
]Unit
value int32 requiredPossible values:
>= 1
Value
increaseBy int32 requiredPossible values:
>= 1
and<= 100
Increment value in percentage
percentageRange object required
Percentage range for the rollout
start int32 requiredPossible values:
<= 100
Percentage starts at
stop int32 requiredPossible values:
<= 100
Percentage stops at
releaseDateTime date-timeRelease date time
segmentId int64Id of the segment targeted by this rule
state stringPossible values: [
ACTIVE
,PAUSED
]Wished state of the rule
status stringPossible values: [
ACTIVE
,PAUSED
,PLANNED
,OUTDATED
]Status of the rule
variationKey stringKey of the variation to serve to visitors matching this rule
exposition int32Possible values:
<= 100
Percentage of the traffic exposed to this rule
name stringName of the rule
reallocation booleanPerform traffic reallocation
release object
Release date information about this rule
releaseFrom date-timeRule being applied from this date
releaseTo date-timeRule being applied to this date
timeZone stringTimezone regarding the release of this rule
rollbackConditions object[]
Conditions for defining rollback
Array [comparisonOperator string requiredPossible values: [
GREATER_THAN
,LESS_THAN
]The rollback condition comparison operator
criteria string requiredPossible values: [
UPLIFT
,DOWNLIFT
,CONVERSION_RATE
]The rollback condition criteria
goalId int64 requiredThe rollback condition goal ID
matchValue double requiredThe rollback condition match value
recipients string[]List of emails of recipients who will be notified when conditions are triggered
target string requiredPossible values: [
RULE
,ENVIRONMENT
]The rollback condition target
visitors int32 requiredThe rollback condition visitors
]segmentId int64ID of the segment targeted by this rule
state stringPossible values: [
ACTIVE
,PAUSED
]Wished state of the rule
status stringPossible values: [
ACTIVE
,PAUSED
,PLANNED
,OUTDATED
]Status of the rule
variationKey stringKey of the variation to serve to visitors matching this rule
]]- featureKey string required
Key used to identify the feature flag
- name string required
Name of the feature flag
- primaryGoalId int64
Primary goal associated with the feature flag
- secondaryGoalIds int64[]
Secondary goals associated with the feature flag
- siteCode string required
Unique identifier of a project in the Kameleoon app
- tags string[]
List of tags associated with the feature flag
variables object[]
Variables associated with the feature flag
Array [key stringPossible values:
<= 255 characters
Key to identify the variable
type stringPossible values: [
BOOLEAN
,NUMBER
,STRING
,JSON
,JS
,CSS
]Type of the variable
value stringValue of the variable
]variations object[]
Variations associated with the feature flag
Array [key stringPossible values:
<= 255 characters
Key to identify the variation
name stringName to identify the variation
variables object[]
Set of variables implemented by the variation
Array [key stringPossible values:
<= 255 characters
Key to identify the variable
type stringPossible values: [
BOOLEAN
,NUMBER
,STRING
,JSON
,JS
,CSS
]Type of the variable
value stringValue of the variable
]]
- 201
- 400
- 403
- 423
- 500
Created
- */*
- Schema
- Example (from schema)
Schema
- dateContentModified date-time
Date and time when the feature flag configuration content was last modified
- dateCreated date-time
Date and time when the feature flag configuration was created
- dateModified date-time
Date and time when the feature flag configuration was last modified
- description string
Description of the feature
environmentConfigurations object[]
Environment-specific configurations for the feature flag
Array [dateModified date-timeThe date when this environment configuration was last modified
defaultVariationKey stringPossible values:
<= 255 characters
Default variation key to serve in this environment
environmentKey stringEnvironment key associated with this configuration
featureEnabled booleanIndicates whether the feature flag is enabled in this environment
integrations object
Integrations associated with the feature flag environment
deliveryRules object[]
List of integrations enabled for delivery rules
Array [customAnalytics string[]Name of the custom analytics
customVariable int32Integration custom variable
integrationName stringPossible 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
,REDSHIFT
,SMARTLOOK
,MOUSEFLOW
,KLAVIYO
,FULLSTORY
,AMPLITUDE
,SNOWPLOW
,JUNE
,MPARTICLE
,BIGQUERY
,RUDDERSTACK
,SNOWFLAKE
,GLASSBOX
,HUBSPOT
,AIR360
,DATADOG
,QUANTUM_METRIC
,KAMELEOON_TRACKING
,CUSTOM_TRACKING
,VERCEL
,AKAMAI
]Name of the integration
]experimentRules object[]
List of integrations enabled for experimentation rules
Array [customAnalytics string[]Name of the custom analytics
customVariable int32Integration custom variable
integrationName stringPossible 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
,REDSHIFT
,SMARTLOOK
,MOUSEFLOW
,KLAVIYO
,FULLSTORY
,AMPLITUDE
,SNOWPLOW
,JUNE
,MPARTICLE
,BIGQUERY
,RUDDERSTACK
,SNOWFLAKE
,GLASSBOX
,HUBSPOT
,AIR360
,DATADOG
,QUANTUM_METRIC
,KAMELEOON_TRACKING
,CUSTOM_TRACKING
,VERCEL
,AKAMAI
]Name of the integration
]rolloutRules object[]
Rollout rules for this environment
Array [- oneOf
- FeatureRolloutExperimentationRule
- FeatureRolloutProgressiveRule
- FeatureRolloutTargetedRule
controlVariationKey stringexposition int32Possible values:
<= 100
Percentage of the traffic exposed to this rule
id int64Unique identifier of the rule
multiArmedBandit booleanEnable dynamic allocation for this rule (Multi-Armed Bandit)
name stringName of the rule
release object
Release date information about this rule
releaseFrom date-timeRule being applied from this date
releaseTo date-timeRule being applied to this date
timeZone stringTimezone regarding the release of this rule
rollbackConditions object[]
Conditions for defining rollback
Array [comparisonOperator string requiredPossible values: [
GREATER_THAN
,LESS_THAN
]The rollback condition comparison operator
criteria string requiredPossible values: [
UPLIFT
,DOWNLIFT
,CONVERSION_RATE
]The rollback condition criteria
goalId int64 requiredThe rollback condition goal ID
id int64The rollback condition ID
matchValue double requiredThe rollback condition match value
recipients string[]List of emails of recipients who will be notified when conditions are triggered
target string requiredPossible values: [
RULE
,ENVIRONMENT
]The rollback condition target
visitors int32 requiredThe rollback condition visitors
]segmentId int64ID of the segment targeted by this rule
state stringPossible values: [
ACTIVE
,PAUSED
]Wished state of the rule
status stringPossible values: [
ACTIVE
,PAUSED
,PLANNED
,OUTDATED
]Status of the rule
trafficAllocations object[]
Traffic allocation settings for the rule
Array [exposition double requiredPossible values:
<= 100
Percentage of the traffic allocated to this variation
variationId int64Internally generated ID of the variation
variationKey string requiredPossible values:
<= 255 characters
Key of the variation
]currentExposition int32Possible values:
<= 100
Current exposition according to rule's configuration
id int64Unique identifier of the rule
name stringName of the rule
release object
Release date information about this rule
releaseFrom date-timeRule being applied from this date
releaseTo date-timeRule being applied to this date
timeZone stringTimezone regarding the release of this rule
rollbackConditions object[]
Conditions for defining rollback
Array [comparisonOperator string requiredPossible values: [
GREATER_THAN
,LESS_THAN
]The rollback condition comparison operator
criteria string requiredPossible values: [
UPLIFT
,DOWNLIFT
,CONVERSION_RATE
]The rollback condition criteria
goalId int64 requiredThe rollback condition goal ID
id int64The rollback condition ID
matchValue double requiredThe rollback condition match value
recipients string[]List of emails of recipients who will be notified when conditions are triggered
target string requiredPossible values: [
RULE
,ENVIRONMENT
]The rollback condition target
visitors int32 requiredThe rollback condition visitors
]rolloutConfiguration object
- oneOf
- CustomRampUpRollout
- ProgressiveExposure
steps object[] required
List of rollout steps
Array [dateTime date-timeDate time of the step
exposure floatExposure of the step
]frequency object
Frequency at which the exposition will evolve
unit string requiredPossible values: [
Nanos
,Micros
,Millis
,Seconds
,Minutes
,Hours
,HalfDays
,Days
,Weeks
,Months
,Years
,Decades
,Centuries
,Millennia
,Eras
,Forever
]Unit
value int32 requiredPossible values:
>= 1
Value
increaseBy int32 requiredPossible values:
>= 1
and<= 100
Increment value in percentage
percentageRange object required
Percentage range for the rollout
start int32 requiredPossible values:
<= 100
Percentage starts at
stop int32 requiredPossible values:
<= 100
Percentage stops at
releaseDateTime date-timeRelease date time
segmentId int64Id of the segment targeted by this rule
state stringPossible values: [
ACTIVE
,PAUSED
]Wished state of the rule
status stringPossible values: [
ACTIVE
,PAUSED
,PLANNED
,OUTDATED
]Status of the rule
variationKey stringKey of the variation to serve to visitors matching this rule
exposition int32Possible values:
<= 100
Percentage of the traffic exposed to this rule
id int64Unique identifier of the rule
name stringName of the rule
release object
Release date information about this rule
releaseFrom date-timeRule being applied from this date
releaseTo date-timeRule being applied to this date
timeZone stringTimezone regarding the release of this rule
rollbackConditions object[]
Conditions for defining rollback
Array [comparisonOperator string requiredPossible values: [
GREATER_THAN
,LESS_THAN
]The rollback condition comparison operator
criteria string requiredPossible values: [
UPLIFT
,DOWNLIFT
,CONVERSION_RATE
]The rollback condition criteria
goalId int64 requiredThe rollback condition goal ID
id int64The rollback condition ID
matchValue double requiredThe rollback condition match value
recipients string[]List of emails of recipients who will be notified when conditions are triggered
target string requiredPossible values: [
RULE
,ENVIRONMENT
]The rollback condition target
visitors int32 requiredThe rollback condition visitors
]segmentId int64ID of the segment targeted by this rule
state stringPossible values: [
ACTIVE
,PAUSED
]Wished state of the rule
status stringPossible values: [
ACTIVE
,PAUSED
,PLANNED
,OUTDATED
]Status of the rule
variationKey stringKey of the variation to serve to visitors matching this rule
]]- featureKey string
Key used to identify the feature flag
- health string
Possible values: [
HEALTHY
,STALE
,SMELLY
,PERMANENT
]Health of the feature flag (for temporary ones)
- id int64
System-generated field to uniquely identify a feature flag
- name string
Name of the feature flag
- primaryGoalId int64
Primary goal associated with the feature flag
- secondaryGoalIds int64[]
Secondary goals associated with the feature flag
- siteCode string
Unique identifier for a project in the Kameleoon app. This is an optional field to be specified in request params.
- tags string[]
List of tags associated with the feature flag. This is an optional field needs to specify in request params.
variables object[]
Variables associated with the feature flag
Array [key stringPossible values:
<= 255 characters
Key to identify the variable
type stringPossible values: [
BOOLEAN
,NUMBER
,STRING
,JSON
,JS
,CSS
]Type of the variable
value stringValue of the variable
]variations object[]
Variations associated with the feature flag
Array [key stringPossible values:
<= 255 characters
Key to identify the variation
name stringName to identify the variation
variables object[]
Set of variables implemented by the variation
Array [key stringPossible values:
<= 255 characters
Key to identify the variable
type stringPossible values: [
BOOLEAN
,NUMBER
,STRING
,JSON
,JS
,CSS
]Type of the variable
value stringValue of the variable
]]
{
"dateContentModified": "2024-12-20T15:04:33.010Z",
"dateCreated": "2024-12-20T15:04:33.010Z",
"dateModified": "2024-12-20T15:04:33.010Z",
"description": "string",
"environmentConfigurations": [
{
"dateModified": "2024-12-20T15:04:33.011Z",
"defaultVariationKey": "string",
"environmentKey": "string",
"featureEnabled": true,
"integrations": {
"deliveryRules": [
{
"customAnalytics": [
"string"
],
"customVariable": 0,
"integrationName": "GOOGLE_ANALYTICS4"
}
],
"experimentRules": [
{
"customAnalytics": [
"string"
],
"customVariable": 0,
"integrationName": "GOOGLE_ANALYTICS4"
}
]
},
"rolloutRules": [
{
"type": "PROGRESSIVE_DELIVERY",
"controlVariationKey": "string",
"exposition": 0,
"id": 0,
"multiArmedBandit": true,
"name": "string",
"release": {
"releaseFrom": "2024-12-20T15:04:33.011Z",
"releaseTo": "2024-12-20T15:04:33.011Z",
"timeZone": "Europe/Paris"
},
"rollbackConditions": [
{
"comparisonOperator": "GREATER_THAN",
"criteria": "UPLIFT",
"goalId": 0,
"id": 0,
"matchValue": 0,
"recipients": [
"string"
],
"target": "RULE",
"visitors": 0
}
],
"segmentId": 0,
"state": "ACTIVE",
"status": "ACTIVE",
"trafficAllocations": [
{
"exposition": 0,
"variationId": 0,
"variationKey": "string"
}
]
},
{
"type": "PROGRESSIVE_DELIVERY",
"currentExposition": 0,
"id": 0,
"name": "string",
"release": {
"releaseFrom": "2024-12-20T15:04:33.013Z",
"releaseTo": "2024-12-20T15:04:33.013Z",
"timeZone": "Europe/Paris"
},
"rollbackConditions": [
{
"comparisonOperator": "GREATER_THAN",
"criteria": "UPLIFT",
"goalId": 0,
"id": 0,
"matchValue": 0,
"recipients": [
"string"
],
"target": "RULE",
"visitors": 0
}
],
"rolloutConfiguration": {
"type": "PROGRESSIVE_EXPOSURE",
"steps": [
{
"dateTime": "2024-12-20T15:04:33.013Z",
"exposure": 0
}
]
},
"segmentId": 0,
"state": "ACTIVE",
"status": "ACTIVE",
"variationKey": "string"
},
{
"type": "PROGRESSIVE_DELIVERY",
"exposition": 0,
"id": 0,
"name": "string",
"release": {
"releaseFrom": "2024-12-20T15:04:33.013Z",
"releaseTo": "2024-12-20T15:04:33.013Z",
"timeZone": "Europe/Paris"
},
"rollbackConditions": [
{
"comparisonOperator": "GREATER_THAN",
"criteria": "UPLIFT",
"goalId": 0,
"id": 0,
"matchValue": 0,
"recipients": [
"string"
],
"target": "RULE",
"visitors": 0
}
],
"segmentId": 0,
"state": "ACTIVE",
"status": "ACTIVE",
"variationKey": "string"
}
]
}
],
"featureKey": "string",
"health": "HEALTHY",
"id": 0,
"name": "string",
"primaryGoalId": 0,
"secondaryGoalIds": [
0
],
"siteCode": "string",
"tags": [
"string"
],
"variables": [
{
"key": "string",
"type": "BOOLEAN",
"value": "string"
}
],
"variations": [
{
"key": "string",
"name": "string",
"variables": [
{
"key": "string",
"type": "BOOLEAN",
"value": "string"
}
]
}
]
}
Bad Request
- */*
- Schema
- Example (from schema)
Schema
- code string
- impersonator string
- message string
- name string
- status string
Possible values: [
SUCCESS
,ERROR
] - sub string
- time int64
- timestamp date-time
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-12-20T15:04:33.013Z"
}
Forbidden
- */*
- Schema
- Example (from schema)
Schema
- code string
- impersonator string
- message string
- name string
- status string
Possible values: [
SUCCESS
,ERROR
] - sub string
- time int64
- timestamp date-time
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-12-20T15:04:33.013Z"
}
Locked
- */*
- Schema
- Example (from schema)
Schema
- code string
- impersonator string
- message string
- name string
- status string
Possible values: [
SUCCESS
,ERROR
] - sub string
- time int64
- timestamp date-time
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-12-20T15:04:33.014Z"
}
Internal Server Error
- */*
- Schema
- Example (from schema)
Schema
- code string
- impersonator string
- message string
- name string
- status string
Possible values: [
SUCCESS
,ERROR
] - sub string
- time int64
- timestamp date-time
{
"code": "string",
"impersonator": "string",
"message": "string",
"name": "string",
"status": "SUCCESS",
"sub": "string",
"time": 0,
"timestamp": "2024-12-20T15:04:33.014Z"
}