Settings

List settings pages

The settings pages you may see, with each field's key, type, allowed values and whether a change needs your confirmation. Secrets (keys, tokens, signing secrets) are never returned.

GET

https://api.gleap.io/v3/settings/pages

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Headers

projectstringrequired

Response

application/json

pagesobject[]required

Show child attributes

canChangebooleanrequired

descriptionstringrequired

pathstringrequired

namestringrequired

keystringrequired

whyNotany

Show 4 more attributes

itemsobject

Show child attributes

opsstring[]required

nameKeystringrequired

perSiteboolean

fieldsobject[]required

Show child attributes

descriptionstringrequired

typeenum<string>required

Allowed values: booleanstringtextnumberenumcolorurlstringListjson

labelstringrequired

keystringrequired

valuesstring[]

minnumber<double>

Show 4 more attributes

maxnumber<double>

needsConfirmationstring

secretboolean

readOnlyboolean

notCoveredstring

notForYouobject[]

Show child attributes

whyNotstringrequired

namestringrequired

keystringrequired

Updated November 1, 2026

curl --request GET \
  --url https://api.gleap.io/v3/settings/pages \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'

{
  "pages": [
    {
      "canChange": true,
      "description": "string",
      "path": "string",
      "name": "string",
      "key": "string",
      "items": {
        "ops": [
          "string"
        ],
        "nameKey": "string"
      },
      "perSite": true,
      "fields": [
        {
          "description": "string",
          "type": "boolean",
          "label": "string",
          "key": "string",
          "values": [
            "string"
          ],
          "min": 0,
          "max": 0,
          "needsConfirmation": "string",
          "secret": true,
          "readOnly": true
        }
      ],
      "notCovered": "string"
    }
  ],
  "notForYou": [
    {
      "whyNot": "string",
      "name": "string",
      "key": "string"
    }
  ]
}

Response

application/json

pagesobject[]required

Show child attributes

canChangebooleanrequired

descriptionstringrequired

pathstringrequired

namestringrequired

keystringrequired

whyNotany

Show 4 more attributes

itemsobject

Show child attributes

opsstring[]required

nameKeystringrequired

perSiteboolean

fieldsobject[]required

Show child attributes

descriptionstringrequired

typeenum<string>required

Allowed values: booleanstringtextnumberenumcolorurlstringListjson

labelstringrequired

keystringrequired

valuesstring[]

minnumber<double>

Show 4 more attributes

maxnumber<double>

needsConfirmationstring

secretboolean

readOnlyboolean

notCoveredstring

notForYouobject[]

Show child attributes

whyNotstringrequired

namestringrequired

keystringrequired

{ "pages": [ { "canChange": true, "description": "string", "path": "string", "name": "string", "key": "string", "items": { "ops": [ "string" ], "nameKey": "string" }, "perSite": true, "fields": [ { "description": "string", "type": "boolean", "label": "string", "key": "string", "values": [ "string" ], "min": 0, "max": 0, "needsConfirmation": "string", "secret": true, "readOnly": true } ], "notCovered": "string" } ], "notForYou": [ { "whyNot": "string", "name": "string", "key": "string" } ] }