Skip to content
Authrim

Get refresh token sharding config

GET
/api/admin/settings/refresh-token-sharding
Code sample: Shell / cURL 
curl --request GET \
  --url https://auth.example.com/api/admin/settings/refresh-token-sharding \
  --header 'Authorization: Bearer <token>'

Returns global or client-specific refresh token shard generation configuration. Optional clientId selects a client override.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
clientId
string

Optional client ID. Omit for global config.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Refresh token sharding configuration.

Media type application/json
object
clientId
string
config
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
key
additional properties
key
additional properties
Example 
{
  "clientId": "__global__",
  "config": {
    "currentGeneration": 2,
    "currentShardCount": 16,
    "previousGenerations": [
      {
        "generation": 1,
        "shardCount": 8,
        "deprecatedAt": 1769999999000
      }
    ],
    "updatedAt": 1770000000000,
    "updatedBy": "admin-api"
  }
}

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