{"uid":"cap_s-n077GWVEw0yPQZxXhVG","slug":"net-protocol-subdomain-renewal-097be8b4","name":"Net Protocol Subdomain Renewal","description":"The onchain data layer","url":"https://netprotocol.app/api/subdomains/v1/renew","method":"POST","headers":{},"bodySchema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"subdomain label; resolves at <name>.hostedon.net"},"durationSeconds":{"type":"integer","description":"lease length in seconds; defaults to 86400 (24h), max 1209600 (2 weeks). Price is $0.01/hour."}}},"responseSchema":{"type":"object","required":["hostname","registration"],"properties":{"hostname":{"type":"string","description":"<name>.hostedon.net"},"registration":{"type":"object","required":["name","owner","paidUntil","target"],"properties":{"name":{"type":"string"},"epoch":{"type":"integer"},"owner":{"type":"string","description":"owner wallet, lowercased 0x"},"target":{"type":"object"},"paidUntil":{"type":"integer","description":"unix seconds the lease expires"},"registeredAt":{"type":"integer"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.24","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"$0.24/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__Y6as3a2tMPm5hKwJt_Xa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.24","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Renews (extends) the lease on an existing .hostedon.net subdomain for a specified duration at $0.01/hour","exampleAgentPrompt":"Renew my 'myapp' subdomain on hostedon.net for 48 hours so it stays active.","exampleUseCases":[{"title":"Keep agent backend subdomain alive","prompt":"My agent is running at devbot.hostedon.net — renew that subdomain for 7 days so the service doesn't go offline."},{"title":"Short-term project subdomain extension","prompt":"Extend the lease on 'hackathon2025' on hostedon.net for exactly 72 hours — I need it through the weekend."},{"title":"Maximum two-week lease renewal","prompt":"Renew my 'staging' subdomain on hostedon.net for the maximum allowed duration of two weeks so I don't have to think about it for a while."}],"resultDescription":"Returns the full hostname (e.g. myapp.hostedon.net), the updated registration object including the owner wallet address (0x...), the unix timestamp when the lease now expires (paidUntil), the epoch, the registration timestamp, and the target routing object.","failureModes":["Subdomain name not found or not previously registered — renewal may fail if the subdomain doesn't exist","durationSeconds exceeds maximum of 1209600 (2 weeks) — request rejected","Insufficient payment or wallet funding — x402 payment fails, lease not extended","Subdomain already expired beyond grace period — renewal may not be possible","Invalid name format — non-alphanumeric or reserved labels rejected"],"whenToPreferThis":"Use this endpoint when you need to extend the active lease of an already-registered .hostedon.net subdomain on the Net Protocol onchain data layer. Choose this over a registration endpoint when the subdomain already exists and you simply need to push the expiry date forward. Ideal for automated agents that manage infrastructure subdomains and need to programmatically top up lease time on a per-hour basis ($0.01/hr) without human intervention.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:28.102Z","isFirstParty":false}