# Site Deploy History

> Site Deploy History is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

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

## Facts

- Endpoint: GET https://agents.withzero.xyz/api/v1/cdn/sites/{slug}/deploys?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-site-deploy-history-52059a19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sH3O67doE5AnSvv52BuOP

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 agents-withzero-xyz-site-deploy-history-52059a19
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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 (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.

## 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/agents-withzero-xyz-site-deploy-history-52059a19/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)