Validate feature import data | Unleash Documentation

curl -X POST https://app.unleash-instance.example.com/api/admin/features-batch/validate \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "project": "My awesome project",
  "environment": "development",
  "data": {
    "features": [
      {
        "name": "my-feature",
        "type": "release",
        "description": "best feature ever",
        "archived": false,
        "project": "default",
        "stale": false,
        "impressionData": false
      }
    ],
    "featureStrategies": [
      {
        "name": "flexibleRollout",
        "id": "924974d7-8003-43ee-87eb-c5f887c06fd1",
        "title": "Rollout 50%",
        "disabled": false,
        "featureName": "my-feature",
        "segments": [
          1
        ],
        "constraints": [],
        "parameters": {
          "groupId": "default",
          "rollout": "50",
          "stickiness": "random"
        }
      }
    ],
    "tagTypes": [
      {
        "name": "simple",
        "description": "Used to simplify filtering of features",
        "icon": "#"
      }
    ]
  }
}'

{
  "errors": [
    {
      "message": "You cannot import a feature that already exist in other projects. You already have the following features defined outside of project default:",
      "affectedItems": [
        "my-feature (in project project-854)"
      ]
    }
  ],
  "warnings": [
    {
      "message": "The following strategy types will be used in import. Please make sure the strategy type parameters are configured as in source environment:",
      "affectedItems": [
        "custom-strategy-7"
      ]
    }
  ],
  "permissions": []
}

Validates a feature flag data set. Checks whether the data can be imported into the specified project and environment. The returned value is an object that contains errors, warnings, and permissions required to perform the import, as described in the import documentation.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Request

importTogglesSchema

projectstringRequired

The exported project

environmentstringRequired

The exported environment

dataobjectRequired

The result of the export operation, providing you with the feature flag definitions, strategy definitions and the rest of the elements relevant to the features (tags, environments etc.)

Response

importTogglesValidateSchema

errorslist of objects

A list of errors that prevent the provided data from being successfully imported.

warningslist of objects

A list of warnings related to the provided data.

permissionslist of objects or null

Any additional permissions required to import the data. If the list is empty, you require no additional permissions beyond what your user already has.

Authentication

Request

Response

Errors