Get strategy segments

GET <your-unleash-url>/api/admin/segments/strategies/:strategyId

Authorization

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

Retrieve all segments that are referenced by the specified strategy. Returns an empty list of segments if the strategy ID doesn't exist.

Request

Path Parameters

• strategyId string required

Responses

• 200

---

segmentsSchema

application/json

Schema

Schema

• segments object[]

  A list of segments

  Array [

  id integer required

  The ID of this segment

  name string required

  The name of this segment

  description string nullable

  The description for this segment

  constraints object[]required

  The list of constraints that are used in this segment

  Array [

  contextName string required

  The name of the context field that this constraint should apply to.

  operator string required

  Possible values: [NOT_IN, IN, STR_ENDS_WITH, STR_STARTS_WITH, STR_CONTAINS, NUM_EQ, NUM_GT, NUM_GTE, NUM_LT, NUM_LTE, DATE_AFTER, DATE_BEFORE, SEMVER_EQ, SEMVER_GT, SEMVER_LT]

  The operator to use when evaluating this constraint. For more information about the various operators, refer to the strategy constraint operator documentation.

  caseInsensitive boolean

  Default value: false

  Whether the operator should be case sensitive or not. Defaults to false (being case sensitive).

  inverted boolean

  Default value: false

  Whether the result should be negated or not. If true, will turn a true result into a false result and vice versa.

  values string[]

  The context values that should be used for constraint evaluation. Use this property instead of value for properties that accept multiple values.

  value string

  The context value that should be used for constraint evaluation. Use this property instead of values for properties that only accept single values.

  ]

  usedInFeatures integer nullable

  The number of feature flags that use this segment. The number also includes the any flags with pending change requests that would add this segment.

  usedInProjects integer nullable

  The number of projects that use this segment. The number includes any projects with pending change requests that would add this segment.

  project string nullable

  The project the segment belongs to. Only present if the segment is a project-specific segment.

  createdBy string nullable

  The creator's email or username

  createdAt date-time required

  When the segment was created

  ]

Example (from schema)

{
  "segments": [
    {
      "id": 2,
      "name": "ios-users",
      "description": "IOS users segment",
      "constraints": [
        {
          "contextName": "appName",
          "operator": "IN",
          "caseInsensitive": false,
          "inverted": false,
          "values": [
            "my-app",
            "my-other-app"
          ],
          "value": "my-app"
        }
      ],
      "usedInFeatures": 3,
      "usedInProjects": 2,
      "project": "red-vista",
      "createdBy": "someone@example.com",
      "createdAt": "2023-04-12T11:13:31.960Z"
    }
  ]
}

Authorization

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

Request

Base URL

<your-unleash-url>

Security Scheme

apiKeybearerToken

apiKey

strategyId — path required

curl / cURL

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

python / requests

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

go / native

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

nodejs / native

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

ruby / Net::HTTP

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

csharp / httpclient

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

php / cURL

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

java / OkHttp

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

powershell / RestMethod

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