Ga direct naar de documentatie
API

De lease verlengen

Nog een uur op de vervaltijd, tot aan de dag waarop een lease wordt afgetopt. Geen body.

POSTapi.openemail.uk/temp-mail/inboxes/{id}/extend

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

POST /temp-mail/inboxes/{id}/extend

Nog een uur op de vervaltijd, tot aan de dag waarop een lease wordt afgetopt. Geen body.

Het inbox-token

shell
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"

Elke aanroep hieronder draagt het token mee dat POST /temp-mail/inboxes teruggaf, in dezelfde Authorization: Bearer-header die een API-sleutel gebruikt. Het adres zelf autoriseert niets, en die scheiding is juist de kern van de functie in plaats van een formaliteit: een wegwerpadres wordt op het moment van uitgifte overhandigd aan de partij die je op afstand houdt.

De id in het pad moet dezelfde inbox aanwijzen als het token. Het token identificeert er op zichzelf al een, dus dit is dubbelop, maar het betekent wel dat een client die twee inboxen door elkaar haalt een 404 krijgt in plaats van stilletjes de verkeerde post te lezen.

Voorbeeld

Het uur wordt bij expiresAt opgeteld en niet bij nu, dus verlengen terwijl er nog tijd op de klok staat behoudt die tijd.

curl
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"
Antwoord
{  "object": "temp_inbox",  "id": "tinb_9c2f41ab7d3e4c118a0f5d72",  "address": "[email protected]",  "domain": "freemailaddress.com",  "createdAt": "2026-09-01T10:00:00.000Z",  "expiresAt": "2026-09-01T13:00:00.000Z",  "extensionsLeft": 21,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

Drieëntwintig verlengingen, en de nieuwe vervaltijd wordt ook afgetopt op 24 uur na createdAt, dus de laatste levert misschien minder dan een vol uur op, en een lease die op de aftopping is aangemaakt levert helemaal niets op. extensionsLeft telt beide plafonds al mee; lees die waarde en expiresAt terug in plaats van je eigen aanroepen te tellen.

Op de aftopping antwoordt hij 409 conflict_error / extension_limit. Daarmee houdt het op: neem een nieuw adres, of een echte mailbox, die niet verloopt.