Header Parameters
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/email-attachments" \ -F file="string"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "filename": "string", "content_type": "string", "size_bytes": 0}Unsubscribe
One-click email opt-out (RFC 8058), reached by clicking a link in a sent email. Public and unauthenticated — the signed token query param is the sole credential, proving the caller holds a link Hail sent to that address. On success, the address is added to the org's suppression list and all future outbound email to it is blocked. Returns an HTML page, not JSON.
Upsert Provider
Save a provider for ``layer`` and make it the active one. A partial write: anything you omit keeps its saved value. Omitting ``api_key`` keeps the stored key, ``params`` keys you don't send are preserved, and omitting ``fallback_enabled`` leaves the flag alone (``false`` on a new row). The merged result — not the partial input — is validated against the layer's schema (422 on a mismatch). 404 on an unknown layer.