Leihfrist verlängern
Eine weitere Stunde auf das Ablaufdatum, bis zu dem Tag, auf den eine Leihfrist begrenzt ist. Kein Body.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /temp-mail/inboxes/{id}/extend
Eine weitere Stunde auf das Ablaufdatum, bis zu dem Tag, auf den eine Leihfrist begrenzt ist. Kein Body.
Das Postfach-Token
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"Jeder Aufruf unten führt das Token mit, das POST /temp-mail/inboxes zurückgegeben hat, im selben Authorization: Bearer-Header, den ein API-Schlüssel verwendet. Die Adresse selbst autorisiert nichts, und diese Trennung ist der Sinn der Funktion und keine Formalität: Eine Wegwerfadresse wird in dem Moment, in dem sie ausgestellt wird, genau der Gegenseite übergeben, die Sie auf Abstand halten wollen.
Die id im Pfad muss dasselbe Postfach benennen wie das Token. Das Token allein identifiziert eines, also ist dies doppelt gemoppelt; es bedeutet aber, dass ein Aufrufer, der zwei Postfächer verwechselt, ein 404 bekommt, statt stillschweigend die falsche Post zu lesen.
Beispiel
Die Stunde wird auf expiresAt addiert, nicht auf jetzt; wer verlängert, solange noch Zeit auf der Uhr ist, behält diese Zeit also.
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"{ "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"}Dreiundzwanzig Verlängerungen, und das neue Ablaufdatum ist zusätzlich auf 24 Stunden nach createdAt gedeckelt; die letzte bringt also womöglich weniger als eine volle Stunde, und eine am Limit angelegte Leihfrist gar keine. extensionsLeft zählt beide Obergrenzen bereits mit; lesen Sie diesen Wert und expiresAt zurück, statt Ihre eigenen Aufrufe zu zählen.
Am Limit antwortet der Aufruf mit 409 conflict_error / extension_limit. Damit ist Schluss: Nehmen Sie eine neue Adresse oder ein echtes Postfach, das nicht abläuft.