{"uid":"cap_2mayPHqIhd1FpocDnjmQ2","slug":"cdn-withzero-xyz-list-hosted-sites-fd0498f4","name":"List Hosted Sites","description":"List the sites you host — slug, visibility, URL or share URL, file count, size, and last update.","url":"https://cdn.withzero.xyz/api/v1/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","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_KtnV_FpqRa1HnOttoWnL_","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"cdn.sites.list:1"}],"brandName":"cdn.withzero.xyz","brandSlug":"cdn-withzero-xyz-mpp","brandBaseUrl":"https://cdn.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns a list of all static sites the authenticated user hosts, including slug, visibility, public/share URL, file count, size, and last update time.","exampleAgentPrompt":"Show me all the static sites I'm currently hosting on cdn.withzero.xyz — I want to see their slugs, whether they're public or private, their URLs, and when they were last updated.","exampleUseCases":[{"title":"Audit hosted site visibility","prompt":"Can you list all the sites I have deployed and tell me which ones are public, which are behind a share link, and which are password-protected? I want to make sure nothing sensitive is accidentally public."},{"title":"Find URL for a specific deployment","prompt":"I need to find the public URL for the site I deployed under the slug 'portfolio-2024' — can you pull up my hosted sites and grab that link for me?"},{"title":"Check storage usage across deployments","prompt":"How many sites am I hosting and how much total storage are they using? Show me the file count and size for each one so I can figure out if I need to clean anything up."}],"resultDescription":"An object containing a 'sites' array sorted by most recently updated first. Each site entry includes: slug (identifier for the deployment), visibility ('public', 'link', or 'password'), url (public URL if public, null otherwise), shareUrl (private share link if visibility is 'link' or 'password', null otherwise — treat as secret), spa (boolean indicating single-page-app routing), files (integer count of deployed files), sizeBytes (total size of those files in bytes), and updatedAt (ISO 8601 timestamp of last deploy or settings change).","failureModes":["401 Unauthorized if authentication credentials are missing or invalid","Empty sites array if no sites have been deployed yet","Sites deployed before site settings existed appear as public with index.html routing"],"whenToPreferThis":"Use this endpoint when you need an overview of all deployed sites for the authenticated user — e.g. to audit visibility settings, retrieve URLs, check storage usage, or identify slugs for use in subsequent PATCH/DELETE operations. It is the only endpoint that returns a full inventory of all sites in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:55:46.991Z","isFirstParty":true,"canonicalSlug":"cdn-withzero-xyz-list-hosted-sites-fd0498f4"}