Skip to main content

/api/admin/state

Deprecation notice

Api admin state is deprecated from version 5. We recommend using the new Environment Import & Export.

In order to access the admin API endpoints you need to identify yourself. Unless you're using the none authentication method, you'll need to create an ADMIN token and add an Authorization header using the token.

Export Feature Flags & Strategies

GET: http://unleash.host.com/api/admin/state/export

The api endpoint /api/admin/state/export will export feature-toggles and strategies as json by default.\ You can customize the export with query parameters:

ParameterDefaultDescription
formatjsonExport format, either json or yaml
downloadfalseIf the exported data should be downloaded as a file
featureTogglestrueInclude feature-toggles in the exported data
strategiestrueInclude strategies in the exported data

Example response:

GET /api/admin/state/export?format=yaml&featureToggles=1&strategies=1

version: 1
features:
- name: Feature.A
description: lorem ipsum
enabled: false
strategies:
- name: default
parameters: {}
variants:
- name: variant1
weight: 50
- name: variant2
weight: 50
- name: Feature.B
description: lorem ipsum
enabled: true
strategies:
- name: ActiveForUserWithId
parameters:
userIdList: '123,221,998'
- name: GradualRolloutRandom
parameters:
percentage: '10'
variants: []
strategies:
- name: country
description: Enable feature for certain countries
parameters:
- name: countries
type: list
description: List of countries
required: true

Import Feature Flags & Strategies

POST: http://unleash.host.com/api/admin/state/import

You can import feature-toggles and strategies by POSTing to the /api/admin/state/import endpoint.\ You can either send the data as JSON in the POST-body or send a file parameter with multipart/form-data (YAML files are also accepted here).

Query Paramters

  • drop - Use this parameter if you want the database to be cleaned before import (all strategies and features will be removed).
  • keep - Use this query parameter if you want to keep all exiting feature flag (and strategy) configurations as is (no override), and only insert missing feature flags from the data provided.

You should be careful using the drop parameter in production environments.

Success: 202 Accepted\ Error: 400 Bad Request

Example body:

{
"version": 1,
"features": [
{
"name": "Feature.A",
"description": "lorem ipsum",
"enabled": false,
"strategies": [
{
"name": "default",
"parameters": {}
}
],
"variants": [
{
"name": "variant1",
"weight": 50
},
{
"name": "variant2",
"weight": 50
}
]
},
{
"name": "Feature.B",
"description": "lorem ipsum",
"enabled": true,
"strategies": [
{
"name": "ActiveForUserWithId",
"parameters": {
"userIdList": "123,221,998"
}
},
{
"name": "GradualRolloutRandom",
"parameters": {
"percentage": "10"
}
}
],
"variants": []
}
],
"strategies": [
{
"name": "country",
"description": "Enable feature for certain countries",
"parameters": [
{
"name": "countries",
"type": "list",
"description": "List of countries",
"required": true
}
]
}
]
}