Skip to content
Authrim

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

Section titled “Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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"
}