Get introspection cache settings

GET

/api/admin/settings/introspection-cache

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/api/admin/settings/introspection-cache \
  --header 'Authorization: Bearer <token>'

Returns active=true introspection response cache settings and source metadata.

Authorizations

• adminBearer
• adminSessionCookie

Responses

200

Introspection response cache settings.

Media type application/json

object

settings

object

enabled

object

value

Resolved setting value.

source

Source for the resolved setting.

string

default

Default value.

metadata

Setting metadata and validation constraints.

object

key

additional properties

description

string

min

number

max

number

validOptions

Array

key

additional properties

ttlSeconds

object

value

Resolved setting value.

source

Source for the resolved setting.

string

default

Default value.

metadata

Setting metadata and validation constraints.

object

key

additional properties

description

string

min

number

max

number

validOptions

Array

key

additional properties

key

additional properties

note

string

key

additional properties

Example

{
  "settings": {
    "enabled": {
      "value": true,
      "source": "kv",
      "default": false,
      "description": "When enabled, caches active=true introspection responses to reduce KeyManager DO and D1 load"
    },
    "ttlSeconds": {
      "value": 60,
      "source": "kv",
      "default": 60,
      "description": "Cache TTL in seconds (recommended: 30-120 seconds)"
    }
  },
  "note": "Cache only stores active=true responses. Revocation checks bypass cache for security."
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}