{"uid":"cap_QwljcFPAptCB6ipxIaGbx","slug":"agents-withzero-xyz-commit-planned-cdn-deploy-40d7b797","name":"Commit Planned CDN Deploy","description":"Make a planned deploy live once its files are uploaded. Takes the same visibility / password / spa options as a kind:site upload.","url":"https://agents.withzero.xyz/api/v1/cdn/deploys/{id}/commit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"spa":{"type":"boolean","description":"Single-page app routing. true: a missing extensionless path (e.g. /dashboard/settings) serves the site index.html with 200 so a client-side router handles it; missing assets (.js, .png…) still 404. false: misses serve the site 404.html, if it has one, with status 404. Omit to keep the current setting (new sites default to false)."},"password":{"type":"string","maxLength":256,"minLength":8,"description":"Sets or changes the site password (implies visibility:\"password\"). 8–256 chars. Omit to keep the current one."},"visibility":{"enum":["public","link","password"],"type":"string","description":"As for kind:site uploads: \"public\" (default for a new site), \"link\" or \"password\". Omit to keep the current visibility."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["walletId","cacheTtlSeconds","files"],"properties":{"spa":{"type":"boolean","description":"kind:site only — whether single-page-app routing is on after this upload."},"files":{"type":"array","items":{"type":"object","required":["url","path","sizeBytes"],"properties":{"url":{"type":"string","description":"Public URL this file is served from."},"path":{"type":"string","description":"Path within your wallet namespace (the part after <walletId>/)."},"sizeBytes":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Decoded file size in bytes."}},"additionalProperties":false},"description":"One entry per uploaded file. kind:file — a single entry. kind:site — one entry per file in the zip; the hosted site's entry point is /<walletId>/<slug>/, which serves <slug>/index.html."},"shareUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"kind:site with link or password visibility — the private URL to share. For a link site it is the whole credential; for a password site viewers also need the password."},"walletId":{"type":"string","description":"Random per-wallet base62 id used as the folder in the URL path (the <walletId> in /<walletId>/<slug>/)."},"warnings":{"type":"array","items":{"type":"string"},"description":"kind:site only — rules in _redirects / _headers that were skipped (unsupported syntax, a disallowed header). The deploy itself succeeded."},"visibility":{"enum":["public","link","password"],"type":"string","description":"kind:site only — the site's visibility after this upload."},"cacheTtlSeconds":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Resolved edge cache lifetime (Cache-Control max-age) applied to every uploaded object."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_D-EaZkAG5mR50Tz7yT9Re","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-x402","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Promotes a pre-uploaded planned deploy to live status, optionally setting visibility, password protection, and SPA routing for the site.","exampleAgentPrompt":"Go ahead and commit deploy abc123 and make it live — set it to public visibility with single-page app routing turned on.","exampleUseCases":[{"title":"Launch password-protected staging site","prompt":"Commit deploy d9f4e2 and make it live with password visibility — set the password to 'StagingAccess2024'."},{"title":"Go live with SPA routing enabled","prompt":"My React app files are all uploaded for deploy b7c91a — commit it now with public visibility and SPA routing turned on so client-side routing works correctly."},{"title":"Publish private link-only marketing site","prompt":"Finalize deploy e3a55b and set its visibility to link-only so only people with the share URL can access it."}],"resultDescription":"Returns a deploy confirmation object including the wallet ID, list of all files with their public URLs, paths, and sizes, the resolved edge cache TTL, the site's active visibility setting, SPA routing status, an optional share URL for link or password-protected sites, and any warnings about skipped redirect or header rules.","failureModes":["Deploy ID not found — 404 if the specified deploy does not exist or belongs to a different wallet","Files not yet fully uploaded — committing before all manifest files are uploaded may fail or result in an incomplete site","Invalid password length — password must be 8–256 characters or the request is rejected","Invalid visibility enum — only 'public', 'link', or 'password' are accepted values","Payment required — 402 if the wallet has insufficient balance for the operation","Conflict — attempting to commit an already-committed or expired deploy"],"whenToPreferThis":"Use this endpoint after completing file uploads for a planned/manifest-based deploy (as opposed to a single-step zip upload). This is the required finalization step in a two-phase large-site deployment workflow — upload files first, then commit. Choose this over single-step site upload endpoints when deploying large sites (up to 5,000 files / 500 MiB) that require a manifest-based approach.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T01:07:27.125Z","isFirstParty":true,"canonicalSlug":"agents-withzero-xyz-commit-planned-cdn-deploy-40d7b797"}