Get all strategies

GET 
<your-unleash-url>/api/admin/strategies

Retrieves all strategy types (predefined and custom strategies) that are defined on this Unleash instance.

Responses

200

strategiesSchema

application/json

Schema

Schema

versionintegerrequired
Version of the strategies schema
Possible values: [1]
Example: 1
strategies object[]required
List of strategies
Array [
titlestringnullable
An optional title for the strategy
Example: GradualRollout - Prod25
namestringrequired
The name (type) of the strategy
Example: flexibleRollout
displayNamestringnullablerequired
A human friendly name for the strategy
Example: Gradual Rollout
descriptionstringnullablerequired
A short description of the strategy
Example: Gradual rollout to logged in users
editablebooleanrequired
Whether the strategy can be edited or not. Strategies bundled with Unleash cannot be edited.
Example: true
deprecatedbooleanrequired
Example: true
parameters object[]required
A list of relevant parameters for each strategy
Array [
namestring
Example: percentage
typestring
Example: percentage
descriptionstring
Example: Gradual rollout to logged in users
requiredboolean
Example: true
]
]

Example (auto)

{
  "version": 1,
  "strategies": [
    {
      "title": "GradualRollout - Prod25",
      "name": "flexibleRollout",
      "displayName": "Gradual Rollout",
      "description": "Gradual rollout to logged in users",
      "editable": true,
      "deprecated": true,
      "parameters": [
        {
          "name": "percentage",
          "type": "percentage",
          "description": "Gradual rollout to logged in users",
          "required": true
        }
      ]
    }
  ]
}

401

Authorization information is missing or invalid. Provide a valid API token as the authorization header, e.g. authorization:*.*.my-admin-token.

application/json

Schema

Schema

idstring
The ID of the error instance
Example: 9c40958a-daac-400e-98fb-3bb438567008
namestring
The name of the error kind
Example: AuthenticationRequired
messagestring
A description of what went wrong.
Example: You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login.

Example (auto)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "AuthenticationRequired",
  "message": "You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login."
}

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L '<your-unleash-url>/api/admin/strategies' \
-H 'Accept: application/json' \
-H 'Authorization: <Authorization>'

Request Collapse all

Base URL

<your-unleash-url>

Auth

Security Scheme

apiKeybearerToken

apiKey

ResponseClear

Click the Send API Request button above and see the response here!