{"uid":"cap_9VcInlc7V490W3hnbJc8R","slug":"withzero-app-deployment-via-zeroclick-c83e07fe","name":"WithZero App Deployment via ZeroClick","description":"Node.js hosting: ship the Node app you built locally, unchanged — full server runtime on Cloud Run with a dedicated Postgres. Native modules OK. App reads DATABASE_URL + listens on PORT. Filesystem is writable but ephemeral (scale-to-zero) — keep durable state in Postgres. Durable /data file storage (1 GiB included).","url":"https://agents.withzero.xyz/api/v1/deploy/apps?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source"],"properties":{"env":{"type":"object","description":"Extra environment variables for your app, KMS-encrypted at rest. DATABASE_URL / PORT / ZERO_* are injected at deploy — do not set them.","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"name":{"type":"string"},"slug":{"type":"string","maxLength":63,"minLength":1,"description":"Subdomain to serve at (<slug>.withzero.xyz). Lowercase letters, digits, hyphens. Defaults to a generated id. A taken slug is a 409 SLUG_TAKEN before any charge."},"source":{"type":"string","minLength":1,"description":"Base64-encoded zip of your Node app (must contain a top-level package.json with a `start` script). Runtime is Node."},"ackEphemeral":{"type":"boolean","description":"Acknowledge the filesystem is ephemeral: required to deploy an app whose package.json depends on sqlite3/better-sqlite3 (else 400 SQLITE_NOT_DURABLE, before any charge). Durable state belongs in the injected DATABASE_URL Postgres."},"term_fee_micros":{"type":"string","pattern":"^[1-9]\\d*$","description":"Direct rail only: per-term hosting fee in micro-USDC. MUST equal the X-Pay-Amount-Micros header and current termFeeMicros. Omit through ZeroClick; its app-terms usage ledger is authoritative."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["appId","slug","url","status","billing_rail","replayed"],"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"null on a fresh accept — poll GET /api/v1/apps/:id for the live serving URL. An idempotent replay returns the URL once the deploy has persisted it."},"slug":{"type":"string"},"appId":{"type":"string"},"status":{"type":"string","description":"'building' on a fresh accept; an idempotent replay returns the app's current status. Poll GET /api/v1/apps/:id for progress."},"replayed":{"type":"boolean"},"billing_rail":{"enum":["direct","zeroclick","internal","key"],"type":"string","description":"Which rail paid for this term: 'direct' = an on-chain USDC charge, 'zeroclick' = a marketplace term grant, 'key' = the buyer account's prepaid balance drawn by an API key, 'internal' = no money moved."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.21","successRate":"0.38","reviews":2,"stars":"1.8","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z3LRyZQwYa9AFtsi6qyBz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_ZS1-sSNVZhNqSLbg2flbu","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Deploy web applications on demand without requiring vendor accounts or API keys, charged per deployment via x402 micropayment.","exampleAgentPrompt":"Deploy my web app to a live URL right now — use WithZero so I don't have to set up any hosting accounts or API keys, and just charge the $0.60 per deployment.","exampleUseCases":[{"title":"Instant prototype hosting for demo","prompt":"I just finished building a small React prototype and need a live URL to share with my client in the next hour — deploy it for me without me having to sign up for any hosting service."},{"title":"Agent-built app goes live","prompt":"The app you just built for me looks good — now deploy it so it's publicly accessible, and handle the payment automatically without me needing to configure anything."},{"title":"Rapid iteration deployment pipeline","prompt":"I need to push a new version of my web app live after every round of changes we make today — deploy the updated build each time and give me the URL so I can test it immediately."}],"resultDescription":"Returns the deployed application's live URL, deployment status, and a unique app identifier. The agent receives confirmation that the app is publicly accessible and can share or use the URL immediately.","failureModes":["Invalid or malformed app bundle causes deployment failure with a 400 error","Insufficient funds or failed x402 payment results in a 402 Payment Required response","App exceeds size or resource limits, returning a 413 or similar capacity error","Deployment infrastructure unavailability returns a 503 or timeout","Missing required configuration fields result in a 422 Unprocessable Entity response"],"whenToPreferThis":"Choose this endpoint when an agent needs to instantly deploy an application to a live public URL without managing hosting provider accounts, API keys, or infrastructure configuration. It is ideal for autonomous agents that need to ship apps on demand with transparent per-deployment micropayment billing and no pre-registration overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":13,"lastUsedAt":"2026-08-24T21:54:27.537Z","lastSuccessfullyRanAt":"2026-08-24T21:54:27.537Z","lastHealthCheckAt":"2026-10-23T00:47:30.262Z","isFirstParty":true,"canonicalSlug":"withzero-app-deployment-via-zeroclick-c83e07fe"}