Get revocation shard config

GET

/api/admin/settings/revocation-shards

Code sample: Shell / cURL

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

Returns generation-based token revocation shard config with legacy compatibility fields.

Authorizations

• adminBearer
• adminSessionCookie

Responses

200

Revocation shard configuration.

Media type application/json

object

currentGeneration

integer

currentShardCount

integer

previousGenerations

Array<object>

object

generation

integer

shardCount

integer

shard_count

integer

activatedAt

integer format: int64

deprecatedAt

integer | null format: int64

createdBy

string

notes

string | null

key

additional properties

updatedAt

integer format: int64

updatedBy

string

current

integer

default

integer

legacyShardCount

integer

kv_config_key

string

legacy_kv_value

string | null

env_value

string | null

note

string

Example

{
  "currentGeneration": 2,
  "currentShardCount": 16,
  "previousGenerations": [
    {
      "generation": 1,
      "shardCount": 8
    }
  ],
  "updatedAt": 1770000000000,
  "updatedBy": "admin-api",
  "current": 16,
  "default": 8,
  "legacyShardCount": 4,
  "kv_config_key": "revocation_shard_config",
  "legacy_kv_value": null,
  "env_value": null,
  "note": "Generation-based sharding. New tokens use embedded shard info (rv{gen}_{shard}_{random}). Legacy tokens use hash-based routing with LEGACY_SHARD_COUNT."
}

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"
}

404

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"
}