Skip to content
Chatto v0.5.0

PushSubscriptionCleanupService

Chatto exposes this service below /api/connect.

Shared message and enum definitions are documented in Shared Types And Enums.

Public capability-authenticated cleanup for browser push subscriptions.

Removes the exact current subscription when its Push API auth secret and per-save cleanup token match. This public RPC requires those capabilities, not an authenticated account session, and does not reveal whether a match existed.

POST /api/connect/chatto.auth.v1.PushSubscriptionCleanupService/DeleteSubscription

Capability-authenticated request to remove an exact push subscription.

FieldTypeDescription
endpointstringComplete push service endpoint URL. Its opaque path identifies the exact browser subscription; a provider host alone is not unique.
authstringAuthentication secret from the same browser PushSubscription.
cleanup_tokenstringPer-save capability supplied with the original Subscribe request. Cleanup is a no-op after any later save replaces this token.

Response from capability-authenticated subscription cleanup. Success does not reveal whether a matching subscription existed.