> ## Documentation Index > Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt > Use this file to discover all available pages before exploring further. # Gérer les feature flags et les règles de rollout > Créez un feature flag et configurez des règles de rollout de targeted delivery dans plusieurs environnements à l'aide de l'Automation API. ## Objectif Ce guide explique comment gérer le cycle de vie d'un feature flag à l'aide de l'Automation API. Configurez le premier flag en suivant les étapes ci-dessous : 1. **Créer un feature flag** en utilisant l'[endpoint create a new feature flag](/api-reference/featureflag/create-a-new-feature-flag-configuration). 2. **Ajouter une règle de rollout** à l'environnement de développement en utilisant l'[endpoint update a feature flag configuration](/api-reference/featureflag/update-a-feature-flag-configuration). 3. **Mettre à jour la règle de rollout** en utilisant l'[endpoint update a single rule by ID](/api-reference/featureflag/update-a-single-rule-by-id). ## Prérequis ### Conditions préalables Avant d'utiliser l'Automation API, assurez-vous d'avoir les informations suivantes : #### Access token L'Automation API nécessite un [access token](/developer-docs/apis/automation-api-rest/get-started/get-started). Obtenez un token en suivant les instructions de [Obtenir un access token](/developer-docs/apis/automation-api-rest/get-started/get-started#1-obtain-an-access-token). #### siteCode Trouvez le `siteCode` en accédant à **Admin** > **Projets** dans le coin inférieur gauche. ![SiteID](https://storage.googleapis.com/kameleoon-storage-documentation/developers/images/api-tutorial/site-id.jpg) ## 1. Créer un feature flag Créez un feature flag appelé `test_feature_flag_post`, par exemple, avec la variable `test_variable`. Comme cette requête ne spécifie pas d'`environmentConfigurations`, le système génère automatiquement des configurations pour les environnements `development`, `staging` et `production`. **Endpoint :** ``` POST https://api.kameleoon.com/feature-flags ``` Voir l'[endpoint Create a new feature flag](/api-reference/featureflag/create-a-new-feature-flag-configuration). **Exemple :** ```bash theme={null} curl -L -X POST 'https://api.kameleoon.com/feature-flags' \ -H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer ' \ --data-raw '{ "featureKey": "test_feature_flag_post", "name": "test_feature_flag_post", "siteCode": "pzllysfw2f", "description": "", "tags": [], "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ], "variations": [ { "name": "On", "key": "on", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] }, { "name": "Off", "key": "off", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] } ], "attributionWindow": 604800000, "archived": false } ' ``` **Réponse :** ```json theme={null} { "id": 13134, "siteCode": "pzllysfw2f", "featureKey": "test_feature_flag_post", "name": "test_feature_flag_post", "description": "", "tags": [], "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ], "variations": [ { "name": "On", "key": "on", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] }, { "name": "Off", "key": "off", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] } ], "secondaryGoalIds": [], "attributionWindow": 604800000, "health": "HEALTHY", "dateCreated": "2025-12-17T10:42:14", "dateModified": "2025-12-17T10:42:14", "dateContentModified": "2025-12-17T10:42:14", "environmentConfigurations": [ { "environmentKey": "production", "featureEnabled": false, "defaultVariationKey": "off", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" }, { "environmentKey": "staging", "featureEnabled": false, "defaultVariationKey": "off", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" }, { "environmentKey": "development", "featureEnabled": true, "defaultVariationKey": "on", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" } ], "createdById": 34255, "archived": false } ``` ## 2. Mettre à jour le feature flag Mettez à jour le feature flag pour ajouter une règle de rollout `TARGETED_DELIVERY` à l'environnement `development` avec la configuration suivante : ![](https://storage.googleapis.com/kameleoon-storage-documentation/developers/images/api-tutorial/rollout-rule-1.png) ![](https://storage.googleapis.com/kameleoon-storage-documentation/developers/images/api-tutorial/rollout-rule-2.png) **Endpoint :** ``` PATCH https://api.kameleoon.com/feature-flags/:siteCode/:featureKey ``` Voir l'[endpoint Update a feature flag configuration](/api-reference/featureflag/update-a-feature-flag-configuration). **Exemple :** ```bash theme={null} curl -L -X PATCH 'https://api.kameleoon.com/feature-flags/pzllysfw2f/test_feature_flag_post' \ -H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer ' \ --data-raw '{ "environmentConfigurations": [ { "environmentKey": "development", "featureEnabled": true, "defaultVariationKey": "on", "rolloutRules": [ { "name": "test rollout rule", "type": "TARGETED_DELIVERY", "variations": [], "trafficAllocations": [ { "variationKey": "on", "exposition": 59.0 } ], "reallocationTimestamp": null, "release": { "releaseFrom": "2025-12-11T11:58:01", "releaseTo": "2025-12-13T11:58:01", "timeZone": "Europe/Paris" }, "state": "ACTIVE", "rollbackConditions": [ { "target": "RULE", "criteria": "CONVERSION_RATE", "comparisonOperator": "GREATER_THAN", "matchValue": 20.0, "goalId": 400899, "visitors": 2, "recipients": [] } ], "segmentId": 403694, "exposition": 59, "variationKey": "on" } ], "integrations": { "deliveryRules": [], "experimentRules": [] } } ] }' ``` **Réponse :** ```json theme={null} { "id": 13134, "siteCode": "pzllysfw2f", "featureKey": "test_feature_flag_post", "name": "test_feature_flag_post", "description": "", "tags": [], "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ], "variations": [ { "name": "On", "key": "on", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] }, { "name": "Off", "key": "off", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] } ], "secondaryGoalIds": [], "attributionWindow": 604800000, "health": "HEALTHY", "dateCreated": "2025-12-17T10:42:14", "dateModified": "2025-12-17T10:42:14", "dateContentModified": "2025-12-17T10:42:14", "environmentConfigurations": [ { "environmentKey": "production", "featureEnabled": false, "defaultVariationKey": "off", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" }, { "environmentKey": "staging", "featureEnabled": false, "defaultVariationKey": "off", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" }, { "environmentKey": "development", "featureEnabled": true, "defaultVariationKey": "on", "rolloutRules": [ { "id": 20557, "name": "test rollout rule", "type": "TARGETED_DELIVERY", "experimentId": 354972, "variations": [], "trafficAllocations": [{ "variationKey": "on", "exposition": 59.0 }], "reallocationTimestamp": null, "release": { "releaseFrom": "2025-12-11T11:58:01", "releaseTo": "2025-12-13T11:58:01", "timeZone": "Europe/Paris" }, "status": "PAUSED", "state": "ACTIVE", "rollbackConditions": [ { "id": 648, "target": "RULE", "criteria": "CONVERSION_RATE", "comparisonOperator": "GREATER_THAN", "matchValue": 20.0, "goalId": 400899, "visitors": 2, "recipients": [] } ], "segmentId": 403694, "exposition": 59, "variationKey": "on" } ], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" } ], "createdById": 34255, "archived": false } ``` ## 3. Mettre à jour la règle de rollout Enfin, changez la `matchValue` des `rollbackConditions` à `25` pour la règle de rollout ID `20557`. **Endpoint :** ``` PATCH https://api.kameleoon.com/feature-flags/rules/:ruleId ``` Voir l'[endpoint Update a feature flag configuration](/api-reference/featureflag/update-a-feature-flag-configuration). **Exemple :** ```bash theme={null} curl -L -X PATCH 'https://api.kameleoon.com/rules/20557' \ -H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer ' \ --data-raw '{ "rollbackConditions": [ { "id": 648, "target": "RULE", "criteria": "CONVERSION_RATE", "comparisonOperator": "GREATER_THAN", "matchValue": 25.0, "goalId": 400899, "visitors": 2, "recipients": [] } ] }' ``` **Réponse :** ```json theme={null} { "id": 13134, "siteCode": "pzllysfw2f", "featureKey": "test_feature_flag_post", "name": "test_feature_flag_post", "description": "", "tags": [], "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ], "variations": [ { "name": "On", "key": "on", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] }, { "name": "Off", "key": "off", "variables": [ { "key": "test_variable", "type": "STRING", "value": "test" } ] } ], "secondaryGoalIds": [], "attributionWindow": 604800000, "health": "HEALTHY", "dateCreated": "2025-12-17T10:42:14", "dateModified": "2025-12-17T10:42:14", "dateContentModified": "2025-12-17T10:42:14", "environmentConfigurations": [ { "environmentKey": "production", "featureEnabled": false, "defaultVariationKey": "off", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" }, { "environmentKey": "staging", "featureEnabled": false, "defaultVariationKey": "off", "rolloutRules": [], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" }, { "environmentKey": "development", "featureEnabled": true, "defaultVariationKey": "on", "rolloutRules": [ { "id": 20557, "name": "test rollout rule", "type": "TARGETED_DELIVERY", "experimentId": 354972, "variations": [], "trafficAllocations": [{ "variationKey": "on", "exposition": 59.0 }], "reallocationTimestamp": null, "release": { "releaseFrom": "2025-12-11T11:58:01", "releaseTo": "2025-12-13T11:58:01", "timeZone": "Europe/Paris" }, "status": "PAUSED", "state": "ACTIVE", "rollbackConditions": [ { "id": 648, "target": "RULE", "criteria": "CONVERSION_RATE", "comparisonOperator": "GREATER_THAN", "matchValue": 25.0, "goalId": 400899, "visitors": 2, "recipients": [] } ], "segmentId": 403694, "exposition": 59, "variationKey": "on" } ], "integrations": { "deliveryRules": [], "experimentRules": [] }, "dateModified": "2025-12-17T10:42:14" } ], "createdById": 34255, "archived": false } ```