# List Hosted CDN Sites

> List Hosted CDN Sites is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-11-21).

Returns a list of all static sites you host, including their slug, visibility, URL or share URL, file count, size in bytes, and last update timestamp.

## Facts

- Endpoint: GET https://agents.withzero.xyz/api/v1/cdn/sites?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 2
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-list-hosted-cdn-sites-be732c66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OAjSDRXHbotuoB2MccXUA

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-list-hosted-cdn-sites-be732c66
```

Example prompt: Show me all the sites I'm currently hosting on WithZero — I want to see each site's slug, whether it's public or private, its URL, and when it was last updated.

## When to prefer this

Use this endpoint when you need to enumerate all hosted sites to find slugs for subsequent PATCH/DELETE operations, audit visibility settings, check storage usage, or identify the most recently updated deployment. It is the authoritative inventory of all sites under the authenticated identity on WithZero's CDN.

## Known failure modes

- 401 Unauthorized — no valid identity/payment credentials provided
- 403 Forbidden — plan required but not active
- Empty sites array if no sites have been deployed yet
- Sites deployed before site settings existed appear as public with index.html discovery

## How this service works

List the sites you host — slug, visibility, URL or share URL, file count, size, and last update.

## Output

Returns an object with a `sites` array sorted by most recently updated first. Each element contains: `slug` (identifier for management operations), `visibility` (public/link/password), `url` (public URL or null), `shareUrl` (private share link or null), `spa` (boolean for single-page-app routing), `files` (integer file count), `sizeBytes` (total deploy size), and `updatedAt` (ISO timestamp of last deploy or settings change).

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "sites"
 ],
 "properties": {
  "sites": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "slug",
     "visibility",
     "url",
     "shareUrl",
     "spa",
     "files",
     "sizeBytes",
     "updatedAt"
    ],
    "properties": {
     "spa": {
      "type": "boolean",
      "description": "Single-page-app routing: extensionless misses serve the site index.html."
     },
     "url": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "description": "Public URL when visibility is public; null otherwise."
     },
     "slug": {
      "type": "string",
      "description": "The slug the site was deployed under — pass it (URL-encoded) to PATCH or DELETE /api/v1/sites/{slug}."
     },
     "files": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Files currently deployed."
     },
     "shareUrl": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "description": "Private URL for link/password sites; null when public. Treat as a secret."
     },
     "sizeBytes": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Total size of those files."
     },
     "updatedAt": {
      "type": "string",
      "description": "ISO time of the last deploy or settings change."
     },
     "visibility": {
      "enum": [
       "public",
       "link",
       "password"
      ],
      "type": "string"
     }
    },
    "additionalProperties": false
   },
   "description": "Most recently updated first. Sites deployed before site settings existed appear as public, found by their index.html."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-list-hosted-cdn-sites-be732c66/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)
