{"uid":"cap_vLsjuTW2loO3h0WE5V07u","slug":"cdn-withzero-xyz-get-site-deploy-history-b6511d42","name":"Get Site Deploy History","description":"A site's deploy history: the live deploy and up to 9 earlier ones you can roll back to.","url":"https://cdn.withzero.xyz/api/v1/sites/{slug}/deploys?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["deploys"],"properties":{"deploys":{"type":"array","items":{"type":"object","required":["deployId","status","files","sizeBytes","createdAt","committedAt","rolledBackFrom"],"properties":{"files":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"status":{"enum":["pending","committing","live","superseded"],"type":"string"},"deployId":{"type":"string"},"createdAt":{"type":"string"},"sizeBytes":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"committedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"rolledBackFrom":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set when this deploy restored an earlier one."}},"additionalProperties":false},"description":"Newest first: the live deploy, up to 9 earlier ones you can roll back to, and any pending plans."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","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_zSCtljk7RF7Kjm2pkEkyz","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"cdn.sites.deploys:1"}],"brandName":"cdn.withzero.xyz","brandSlug":"cdn-withzero-xyz-mpp","brandBaseUrl":"https://cdn.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns a site's deploy history: the currently live deploy and up to 9 earlier ones available for rollback.","exampleAgentPrompt":"Can you pull up the deploy history for my site 'my-portfolio' on cdn.withzero.xyz? I want to see which deploys are available and which one is currently live.","exampleUseCases":[{"title":"Audit recent site deployments","prompt":"Show me all the recent deploys for my site 'landing-page' — I want to know when each one was committed and which one is currently live."},{"title":"Find a deploy to roll back to","prompt":"What previous deploys do I have available for my site 'docs-site'? I need to find an older version I can restore after today's bad push."},{"title":"Check deploy status after upload","prompt":"I just uploaded a new build for my site 'store-frontend' — can you check its deploy history to confirm whether the new deploy is live or still pending?"}],"resultDescription":"Returns an array of deploy objects ordered newest first, each containing: deployId (string), status (one of pending/committing/live/superseded), files (integer count), sizeBytes (integer), createdAt (ISO timestamp), committedAt (ISO timestamp or null), and rolledBackFrom (deploy ID string or null, set when the deploy was a rollback). The array includes the current live deploy plus up to 9 earlier ones eligible for rollback, and any pending plans.","failureModes":["Site slug not found — returns 404 if the slug does not match any hosted site","Unauthorized access — returns 401/403 if the caller does not own the site","Empty deploys array — new site with no completed deploys yet","Network or CDN timeout — returns 5xx if the origin is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to inspect a site's deployment history, verify which deploy is currently live, identify candidates for rollback, or audit timestamps and file counts across recent deploys. Prefer this over the rollback endpoint when the goal is read-only inspection rather than actually restoring a previous deploy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T09:38:45.736Z","isFirstParty":true,"canonicalSlug":"cdn-withzero-xyz-get-site-deploy-history-b6511d42"}