{"uid":"cap_H3TWoOHoMc8v5mHFvSgwb","slug":"stableemail-update-8f8576c6","name":"StableEmail Update Subdomain Inbox Settings","description":"Update subdomain inbox settings (free)","url":"https://stableemail.dev/api/subdomain/inbox/update?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["subdomain","localPart"],"properties":{"forwardTo":{"anyOf":[{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"localPart":{"type":"string","pattern":"^[a-z0-9][a-z0-9._+-]{0,62}[a-z0-9]$","maxLength":64,"minLength":1},"subdomain":{"type":"string","allOf":[{"pattern":"^[a-z0-9][a-z0-9-]{1,28}[a-z0-9]$"},{"pattern":"^(?!.*--)"}]},"retainMessages":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["email","send","inbox","forwarding","subdomain","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_2p17KxgDnSfPAvjtFuOwS","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableEmail","brandSlug":"stableemail","brandBaseUrl":"https://stableemail.dev","brandDocsUrl":"https://stableemail.dev","whatItDoes":"Updates the forwarding address and message retention settings for a subdomain inbox on StableEmail","exampleAgentPrompt":"Update my StableEmail subdomain inbox — subdomain 'mycompany', local part 'hello' — so it forwards to alice@example.com and retains messages.","exampleUseCases":null,"resultDescription":"A confirmation response indicating the subdomain inbox settings have been updated, reflecting the new forwarding address (or null to disable forwarding) and message retention preference.","failureModes":["Invalid subdomain format — must be 3-30 lowercase alphanumeric characters with hyphens, no double hyphens","Invalid localPart format — must be 1-64 lowercase alphanumeric characters with allowed symbols","Invalid forwardTo email address format","Subdomain does not exist or is not owned by the caller","Missing required fields subdomain or localPart returns validation error"],"whenToPreferThis":"Use this endpoint when you need to change the forwarding destination or retention behavior of an existing subdomain inbox on StableEmail. This is free and does not require purchasing a new inbox. Prefer this over other endpoints when the inbox already exists and you only need to reconfigure its settings rather than create or top up.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:44:19.377Z","isFirstParty":false,"canonicalSlug":"stableemail-update-8f8576c6"}