{"uid":"cap_zMOP-jCOqcQWJH_NQG_24","slug":"machine-inbox-extend-inbox-883116a1","name":"Machine Inbox — Extend Inbox","description":"Pay-per-use email inboxes for software agents. Pay $2.00 through Stripe Machine Payments Protocol or x402 USDC, receive mail, and reply over HTTP.","url":"https://machineinbox.com/api/v1/inboxes/%7BinboxId%7D/extend","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object","required":["inboxId"],"properties":{"inboxId":{"type":"string","format":"uuid"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"applied":true,"extension":{"days":7,"inboxId":"uuid","expiresAt":"2026-09-01T12:00:00.000Z"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ffWEs2b5vTXtepg5lD8fs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extends an existing Machine Inbox email inbox by 7 days for $1 USDC via x402.","exampleAgentPrompt":"My Machine Inbox inbox abc-1234-uuid is about to expire — extend it by 7 more days using $1 USDC.","exampleUseCases":[{"title":"Keep agent inbox alive during long task","prompt":"My agent has an active inbox with ID e7f3-ab12-uuid that's expiring soon — extend it for another 7 days so the agent can keep receiving replies."},{"title":"Renewal before onboarding campaign ends","prompt":"We're mid-way through a multi-week onboarding campaign and inbox uuid-5678-onboard is about to expire — pay $1 USDC to extend it 7 more days."},{"title":"Support inbox for an agent fleet","prompt":"Our support agent's inbox uuid-9900-support expires tomorrow — extend it by 7 days so the fleet doesn't miss any incoming messages."}],"resultDescription":"Returns a JSON object confirming the extension was applied (applied: true), along with the extension details including the number of days added (7), the inboxId, and the new expiration timestamp in ISO 8601 format.","failureModes":["Inbox ID not found — returns error if inboxId is invalid or doesn't exist","Payment failure — x402 USDC payment of $1 not received or rejected","Inbox already expired — cannot extend an inbox that is no longer active","Duplicate extension attempt in quick succession — may not be idempotent, could double-charge"],"whenToPreferThis":"Use this endpoint when an existing Machine Inbox inbox is approaching its expiration and needs to be kept alive for another 7 days. Prefer this over creating a new inbox when continuity of the same email address matters (e.g., ongoing correspondence, agent pipelines waiting on replies). This is the right choice if you already have an inboxId and simply want to extend its lifetime rather than provision a fresh inbox.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:30:01.926Z","isFirstParty":false}