{"uid":"cap_l0ESmfqpZBf8An6qE6KLQ","slug":"vm402-vm-topup-63d32d28","name":"vm402 VM Topup","description":"Anonymous metered cloud VPS (Linux VMs) — deploy an app, host a server, or run sandboxed code. You get a VM and can do what you want. No accounts; a bearer token per VM. Create and topup are paid over L402 (lightning) at 10 sats/hour, or natively over x402 (USDC on Base) at $0.01/hour. Call with no payment to get a 402 carrying both challenges: pay the lightning invoice and retry with \"Authorization: L402 <token>:<preimage>\", or sign the x402 exact-scheme USDC payment and retry with it base64-encoded in the \"payment-signature\" header. For x402 on other networks or MPP, route the request through https://l402.space/<rail>/<url-encoded-endpoint>.","url":"https://vm402.com/vms/%7Bid%7D/topup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hours":{"type":"number","description":"Hours to add; price is hours × rate"}}},"responseSchema":{"allOf":[{"type":"object","properties":{"id":{"type":"string"},"topup":{"type":"object","properties":{"url":{"type":"string"},"note":{"type":"string"}}},"status":{"enum":["active","parked"],"type":"string"},"expires_at":{"type":"string","format":"date-time"},"remaining_seconds":{"type":"integer"}}},{"type":"object","properties":{"receipt":{"type":"object","properties":{"hours":{"type":"number"},"scheme":{"type":"string"},"paid_at":{"type":"string","format":"date-time"}}}}}]},"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_tAonp6cqqmoCUsJ11acZp","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":"Adds paid runtime hours to an existing anonymous metered VM, extending its active lifetime","exampleAgentPrompt":"Top up my vm402 VM (ID: abc123) with 10 more hours so it keeps running — pay with USDC on Base.","exampleUseCases":[{"title":"Keep CI runner alive overnight","prompt":"My vm402 VM (ID: vm-xyz789) is running out of time — add 8 more hours so my build pipeline doesn't get interrupted."},{"title":"Extend scraping job runtime","prompt":"I've got a long web scraping job running on vm402 VM id: vm-def456, add 24 hours to make sure it finishes."},{"title":"Top up ephemeral dev sandbox","prompt":"Top up my anonymous vm402 sandbox (vm-qrs321) with 2 extra hours so I can finish testing before it parks."}],"resultDescription":"Returns the VM's updated status (active or parked), the new expiry timestamp, remaining seconds of runtime, and a receipt object containing the number of hours purchased, the payment scheme used (e.g. l402 or x402), and the timestamp payment was processed.","failureModes":["Payment not provided — server returns HTTP 402 with both a Lightning invoice and an x402 USDC challenge; caller must pay and retry with the appropriate authorization header","Invalid or expired VM ID — VM not found or already terminated","Malformed payment proof — incorrect preimage for L402 or invalid payment signature for x402","Insufficient payment — hours requested × rate does not match payment amount","Network or provider error causing 5xx response"],"whenToPreferThis":"Use this endpoint when you already have a running vm402 VM (identified by its bearer token and ID) and need to extend its lifetime before it parks or expires. This is the correct endpoint for adding hours to an existing VM — not for creating a new one. Choose this over cloud provider APIs when you need fully anonymous, account-free compute paid via micropayments (Lightning sats or USDC on Base).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-06T12:30:27.425Z","isFirstParty":false,"canonicalSlug":"vm402-vm-topup-63d32d28"}