{"uid":"cap_QpVhU73CTz5nkhKjdvnQ-","slug":"agents-withzero-xyz-extend-app-hosting-term-withzero-26a5a35e","name":"Extend App Hosting Term (WithZero)","description":"Extend an app hosting term.","url":"https://agents.withzero.xyz/api/v1/deploy/apps/{id}/renew","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":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["appId","termExpiresAt","resumed","billing_rail","replayed"],"properties":{"appId":{"type":"string"},"resumed":{"type":"boolean","description":"True when this renewal brought a paused (lapsed) app back — a redeploy from its last source was queued."},"replayed":{"type":"boolean"},"billing_rail":{"enum":["direct","zeroclick"],"type":"string"},"termExpiresAt":{"type":"string","description":"The new hosting-term expiry after this renewal (ISO-8601)."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.92","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"60.0000","medianCents":"60.0000","p90Cents":"60.0000","minCents":"60.0000","maxCents":"60.0000","p95Cents":"60.0000","sampleCount":12,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.6/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.6","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h4FN8xaokVD3-WgXhPWr1","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_avVb44GxrNGtNhxTBizvl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-mpp","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Renews the hosting term for a deployed app on WithZero, optionally reactivating a paused/lapsed app.","exampleAgentPrompt":"Renew the hosting term for my WithZero app with ID app_abc123 — keep it running and pay the required hosting fee.","exampleUseCases":[{"title":"Prevent app expiry before deadline","prompt":"My WithZero app with ID app_xyz789 is about to expire — can you renew its hosting term right now so it stays online?"},{"title":"Reactivate a paused lapsed app","prompt":"My app app_def456 on WithZero went offline because the hosting lapsed — please renew it to bring it back up."},{"title":"Automate monthly app renewal","prompt":"Every month, renew the hosting term for my WithZero app app_ghi321 so it never goes down due to expiry."}],"resultDescription":"Returns the app ID, the new hosting term expiry date (ISO-8601), whether the app was resumed from a paused/lapsed state, the billing rail used (direct or zeroclick), and whether the operation was replayed.","failureModes":["App ID not found — 404 error","Insufficient payment or mismatched term_fee_micros — payment error","App already has an active non-expiring term — may return conflict","Invalid app ID format — 400 validation error","Payment rail mismatch between direct and zeroclick modes"],"whenToPreferThis":"Use this endpoint when you need to extend or renew the hosting period of an existing WithZero-deployed app, especially when the app is about to lapse or has already paused. Prefer this over redeploying from scratch when the app state and source are intact and only the hosting term needs refreshing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":13,"lastUsedAt":"2026-08-24T23:47:00.932Z","lastSuccessfullyRanAt":"2026-08-24T23:47:00.932Z","lastHealthCheckAt":"2026-09-15T12:44:11.563Z","isFirstParty":true}