Skip to main content
GET
/
v1
/
flags
List Flag
curl --request GET \
  --url https://flags.eu.confidence.dev/v1/flags \
  --header 'Authorization: Bearer <token>'
{
  "flags": [
    {
      "displayName": "<string>",
      "state": "STATE_UNSPECIFIED",
      "createTime": {},
      "updateTime": {},
      "creator": "<string>",
      "updater": "<string>",
      "name": "<string>",
      "description": "<string>",
      "schema": {
        "schema": [
          {}
        ]
      },
      "variants": [
        {
          "name": "<string>",
          "value": {},
          "createTime": {},
          "updateTime": {},
          "creator": "<string>",
          "updater": "<string>",
          "labels": [
            {}
          ],
          "description": "<string>",
          "imageUri": "<string>"
        }
      ],
      "rules": [
        {
          "segment": "<string>",
          "assignmentSpec": {
            "bucketCount": {},
            "assignments": [
              {
                "assignmentId": "<string>",
                "variant": {
                  "variant": "<string>"
                },
                "fallthrough": {},
                "clientDefault": {},
                "bucketRanges": [
                  {
                    "lower": {},
                    "upper": {}
                  }
                ]
              }
            ]
          },
          "usageMetadata": {
            "resolveCount": 123,
            "applyCount": 123,
            "lastResolveTime": {},
            "lastApplyTime": {},
            "assignmentUsageMetadata": [
              {
                "assignmentId": "<string>",
                "resolveCount": 123,
                "applyCount": 123,
                "lastApplyTime": {},
                "emptyTargetingKeyCount": 123
              }
            ]
          },
          "enabled": true,
          "createTime": {},
          "updateTime": {},
          "creator": "<string>",
          "updater": "<string>",
          "name": "<string>",
          "description": "<string>",
          "targetingKeySelector": "<string>",
          "environments": [
            "<string>"
          ],
          "labels": [
            {}
          ],
          "materializationSpec": {
            "writeMaterialization": "<string>",
            "readMaterialization": "<string>",
            "mode": {
              "materializationMustMatch": true,
              "segmentTargetingCanBeIgnored": true
            }
          }
        }
      ],
      "clients": [
        "<string>"
      ],
      "archiveTime": {},
      "labels": [
        {}
      ],
      "usageMetadata": {
        "resolveCount": 123,
        "lastResolveTime": {},
        "lastApplyTime": {}
      },
      "owner": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://confidence.spotify.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
pageSize
object

The maximum number of flags to fetch.

​
pageToken
string

Token used for pagination.

​
filter
string

Filter to apply to the flags. This follows the lucene query string format

​
orderBy
string

Sort each column of the flags table.

Response

200 - application/json

OK

​
flags
Flag · object[]
required

Flag: List of flags.

​
nextPageToken
string

A token that can be used to fetch more flags, empty if no more flags are available.