{"uid":"cap_OAjSDRXHbotuoB2MccXUA","slug":"agents-withzero-xyz-list-hosted-cdn-sites-be732c66","name":"List Hosted CDN Sites","description":"List the sites you host — slug, visibility, URL or share URL, file count, size, and last update.","url":"https://agents.withzero.xyz/api/v1/cdn/sites?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"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},"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_FTIucKBzo2BYSF5vuC4BH","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":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Audit hosted site visibility","prompt":"List all my hosted sites and tell me which ones are public versus private or password-protected — I want to make sure nothing sensitive is accidentally public."},{"title":"Check site sizes before cleanup","prompt":"Show me all my deployed sites along with their file counts and sizes so I can figure out which ones are taking up the most space and might need to be deleted."},{"title":"Find site slug for management","prompt":"I need the slug for the site I deployed last — can you pull up all my hosted sites sorted by most recently updated so I can find it?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-11-20T20:21:50.330Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-22T19:42:00.117Z","isFirstParty":true,"canonicalSlug":"agents-withzero-xyz-list-hosted-cdn-sites-be732c66"}