{"uid":"cap_sH3O67doE5AnSvv52BuOP","slug":"agents-withzero-xyz-site-deploy-history-52059a19","name":"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://agents.withzero.xyz/api/v1/cdn/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.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_6MaLRm9wcx2KhP2ge8rI3","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 site's deploy history, including the live deploy and up to 9 earlier ones available for rollback.","exampleAgentPrompt":"Can you show me the deploy history for my site with slug 'my-portfolio' — I want to see which deploys are available and which one is currently live so I can decide if I need to roll back?","exampleUseCases":[{"title":"Checking before a rollback","prompt":"Show me the last 10 deploys for my site 'landing-page-v2' — I think something broke in the latest deploy and I want to see which earlier version I can restore."},{"title":"Auditing deployment timeline","prompt":"Pull up the full deploy history for my 'company-docs' site so I can see when each version went live and how large each deploy was."},{"title":"Confirming a fresh deploy went live","prompt":"I just pushed a new deploy to my site 'product-launch' — can you check the deploy history to confirm it's now showing as live and what its deploy ID is?"}],"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 (string or null, set when the deploy restored an earlier one). Typically includes the current live deploy plus up to 9 earlier ones eligible for rollback.","failureModes":["Invalid or unknown slug returns an error or empty deploys array","Site has no deploy history if never deployed","Authentication/authorization failure if the site belongs to a different identity","Network or upstream CDN service errors causing 5xx responses"],"whenToPreferThis":"Use this endpoint when you need to inspect or audit a specific site's deployment history on the WithZero CDN platform, especially before deciding whether to roll back to a previous deploy. Prefer this over general site listing endpoints when you need deploy-level detail (status, file counts, sizes, timestamps) for a known site slug.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:35:22.198Z","isFirstParty":true,"canonicalSlug":"agents-withzero-xyz-site-deploy-history-52059a19"}