Unsubscribe from sub-processor change notices
POST /v1/subprocessor-notices/removals: Unsubscribe from sub-processor change notices.
POST /
The one-click unsubscribe behind the signed link in every sub-processor notice email (the landing page posts the link’s token). Idempotent. Always answers 202 with the same body for a well-formed token, whether its subscription was removed now, was already gone or the signature did not match; only a malformed token is 400 parameter_invalid (param token). A waitlist removal token is never accepted here. Not served on the standby host (503).
- Scope
public- Auth
- None
- Since
- 1.0
Request body
Section titled “Request body”
The token of the unsubscribe link (base64url).tokenstring Requiredmin length 43 · max length 43
Responses
Section titled “Responses”- 202 Accepted. The same body for every well-formed token. Accepted
- 400 Invalid request. Codes: parameter_invalid, parameter_missing, version_unsupported and resource-specific codes from the catalogue. Error
- 429 Code: rate_limited. Retry-After is set. Error
- 503 Code: service_unavailable. Retry-After is set; writes are paused. Error
- default Any other error, including internal_error. Every code is in the error catalogue. Error
Errors share one shape; see the error code catalogue.
curl -X POST \ "https://api.ohauthcat.com/v1/subprocessor-notices/removals" \ -H "Content-Type: application/json" \ -d '{ "token": "sk_test_example"}'const response = await fetch("https://api.ohauthcat.com/v1/subprocessor-notices/removals", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ "token": "sk_test_example" }),});const data = await response.json();import osimport requests
response = requests.post( "https://api.ohauthcat.com/v1/subprocessor-notices/removals", json={ "token": "sk_test_example", },)data = response.json(){ "accepted": true}