Clean up deprecated refresh token generation

DELETE

/api/admin/settings/refresh-token-sharding/cleanup

Code sample: Shell / cURL

curl --request DELETE \
  --url 'https://auth.example.com/api/admin/settings/refresh-token-sharding/cleanup?generation=1' \
  --header 'Authorization: Bearer <token>'

Deletes database records for a deprecated refresh token generation after verifying no active token families remain.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Query Parameters

generation

required

integer

Deprecated generation number to clean up.

clientId

string

Optional client ID.

Responses

200

Deprecated refresh token generation cleaned up.

Media type application/json

object

success

boolean

message

string

deleted_records

integer

note

string

key

additional properties

Example

{
  "success": true,
  "message": "Generation 1 cleaned up",
  "deleted_records": 2,
  "note": "DO storage will be garbage collected by Cloudflare automatically"
}

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