Domains

Cleanup stale domains

Clean up custom domains that have been inactive (not verified) for a specified number of days. This uses Cloudflare as the source of truth to determine domain activity.

post/api/domains/cleanup

Request

  • Base URL: https://[tenant_id].logto.app
  • URL: https://[tenant_id].logto.app/api/domains/cleanup
  • Auth: OAuth 2 (client credentials, token URL /oidc/token, scopes: all)

Request body

staleDaysnumber required

The number of days a domain must be inactive before it is considered stale and eligible for cleanup.

Response

The cleanup result summary.

scannedCountnumber required
deletedCountnumber required
skippedActiveCountnumber required
failedCountnumber required

Changes

No recorded changes to this operation across all 8 revisions of this API.