BSV blockchainBSV blockchain

Run the janitor service

POST/admin/janitor

Runs the janitor service, which checks SHIP/SLAP hosts for availability, revokes records for downed hosts after the configured threshold, and optionally bans domains. Returns a detailed JanitorReport.

Response

Janitor run completed with report.

statusstring
messagestring
dataobject

Detailed janitor run results.

Bad request — validation error or missing required field.

statusstring
messagestring
codestring

Stable machine-readable error code (see specs/errors.md).

No authentication credentials provided.

statusstring
messagestring
codestring

Stable machine-readable error code (see specs/errors.md).

Credentials provided but insufficient.

statusstring
messagestring
codestring

Stable machine-readable error code (see specs/errors.md).

Request
curl -X POST "https://{fqdn}/admin/janitor" \
  -H "Authorization: Bearer <token>" \
  -H "Authorization: Bearer <token>"
Response
{
  "status": "string",
  "message": "string",
  "data": {}
}