Inboxes

Extend an active inbox by seven days with Stripe MPP for $1.00

Adds seven days to the current expiry. The mailbox token goes in the X-Mailbox-Token header because Authorization carries the MPP Payment credential on the paid retry. An inbox can never live more than 35 days into the future, and an expired inbox cannot be extended - extend at least ten minutes before expiry.

post/api/v1/inboxes/{inboxId}/extend

Request

  • Base URL: https://machineinbox.com
  • URL: https://machineinbox.com/api/v1/inboxes/{inboxId}/extend
  • Auth: none required

Path parameters

inboxIdstring uuid required

Headers

X-Mailbox-Tokenstring

The mi_live_... mailbox token, required on the paid retry (the unpaid challenge needs no credentials). Used instead of Authorization: Bearer because the paid retry carries the MPP Payment credential in Authorization.

Idempotency-Keystring

Strongly recommended for inbox creation and required for replies. Reuse it only to retry the identical operation.

Request body

object required

Response

Extension applied; the new expiry is returned.

appliedunknown required
replayedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.