logo
HandleRequest handle unsubscribe confirmation email

Request handle unsubscribe confirmation email

Initiates handle unsubscribe. A confirmation email is sent to the handle's current destination. On confirmation, the handle stops routing but the name remains permanently reserved. Returns a generic accepted response regardless of whether the handle exists (anti-enumeration).

curl -X GET "https://mail.haltman.io/api/handle/unsubscribe?handle=example_string" \
  -H "Content-Type: application/json"
{
  "ok": true,
  "accepted": true,
  "action": "handle_unsubscribe",
  "handle": "example_string",
  "confirmation": {
    "sent": true,
    "ttl_minutes": 42,
    "reason": "example_string"
  }
}
GET
/api/handle/unsubscribe
GET
query
handlestring
Required

The handle to unsubscribe.

Request Preview
Response

Response will appear here after sending the request

Query Parameters

handlestring
Required

The handle to unsubscribe.

Responses

okboolean
Required
acceptedboolean
actionstring
Allowed values:handle_unsubscribe
handlestring
confirmationobject