# Commit Planned CDN Deploy

> Commit Planned CDN Deploy is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-11-18).

Promotes a pre-uploaded planned deploy to live status, optionally setting visibility, password protection, and SPA routing for the site.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/cdn/deploys/{id}/commit?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-commit-planned-cdn-deploy-40d7b797
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QwljcFPAptCB6ipxIaGbx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-withzero-xyz-commit-planned-cdn-deploy-40d7b797 -d '<json body>'
```

Example prompt: Go ahead and commit deploy abc123 and make it live — set it to public visibility with single-page app routing turned on.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Make a planned deploy live once its files are uploaded. Takes the same visibility / password / spa options as a kind:site upload.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-commit-planned-cdn-deploy-40d7b797/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)
