# Get Site Deploy History

> Get Site Deploy History is a paid API for AI agents from cdn.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-10-11).

Returns a site's deploy history: the currently live deploy and up to 9 earlier ones available for rollback.

## Facts

- Endpoint: GET https://cdn.withzero.xyz/api/v1/sites/{slug}/deploys?utm_source=zero.xyz
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: cdn.withzero.xyz
- Website: https://cdn.withzero.xyz
- Canonical page: https://www.zero.xyz/c/cdn-withzero-xyz-get-site-deploy-history-b6511d42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vLsjuTW2loO3h0WE5V07u

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 cdn-withzero-xyz-get-site-deploy-history-b6511d42
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

A site's deploy history: the live deploy and up to 9 earlier ones you can roll back to.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "slug"
 ],
 "properties": {
  "slug": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cdn-withzero-xyz-get-site-deploy-history-b6511d42/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cdn.withzero.xyz](https://www.zero.xyz/host/cdn.withzero.xyz/llms.txt)