# WithZero Annotation Review Session Creator

> WithZero Annotation Review Session Creator is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, $0.020000/call, status unknown (last checked 2026-10-13).

Creates a human annotation review session for a live webpage URL or a static HTML/CSS/JS bundle, returning a shareable reviewer link and optional source download URL.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/annotate/reviews?utm_source=zero.xyz
- Price: $0.020000/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-withzero-annotation-review-session-creator-ce96cf76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YMPiMPhBVov9BQurOY7-j

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-withzero-annotation-review-session-creator-ce96cf76 -d '<json body>'
```

Example prompt: Set up an annotation review session for https://myapp.example.com/checkout so I can share it with a human reviewer — send me back the share link and notify my webhook at https://hooks.myapp.com/reviews when they submit their feedback.

## When to prefer this

Use this endpoint when you need a human reviewer to annotate a specific web page or static site bundle with structured feedback and you want a shareable link delivered instantly. It is the right choice when you need to collect human-in-the-loop UI/UX or content annotations without setting up your own review infrastructure, and especially when you want a webhook callback to automate downstream processing of the submitted review.

## Known failure modes

- Both url and zipData provided simultaneously — mutually exclusive fields cause a validation error
- Neither url nor zipData provided — at least one is required
- zipData exceeds 10 MiB decoded — payload too large error
- Invalid URI format for url or callbackUrl — schema validation failure
- entryFile not found within the zip — bundle hosting fails
- Invalid base64 encoding in zipData — decoding error
- Webhook at callbackUrl unreachable when review is submitted — silent delivery failure

## How this service works

Create an annotation review session. Pass `url` for a live webpage, or `zipData` (base64 zip) + optional `entryFile` for a static code bundle. Returns a `shareUrl` for the human reviewer and, for bundle reviews, a `bundleUrl` to download the original source afterward.

## Output

Returns a JSON object containing a UUID reviewId identifying the session, a shareUrl to give to the human reviewer so they can open and annotate the page, and (for bundle-based reviews) a bundleUrl to download the original source zip afterward.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "entryFile"
 ],
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "The URL of the page to annotate. Mutually exclusive with zipData."
  },
  "zipData": {
   "type": "string",
   "description": "Base64-encoded zip of static site files (HTML/CSS/JS). When provided, the site is hosted by annotate and the reviewer annotates it directly. Mutually exclusive with url. Max 10 MiB decoded."
  },
  "entryFile": {
   "type": "string",
   "default": "index.html",
   "description": "Entry point filename within the zip. Defaults to index.html. Only used when zipData is provided."
  },
  "callbackUrl": {
   "type": "string",
   "format": "uri",
   "description": "Webhook URL to POST the full review JSON to when the human submits."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "reviewId",
  "shareUrl"
 ],
 "properties": {
  "reviewId": {
   "type": "string",
   "description": "UUID of the created review session."
  },
  "shareUrl": {
   "type": "string",
   "description": "URL to share with the human reviewer."
  },
  "bundleUrl": {
   "type": "string",
   "description": "Download URL for the original source zip. Present only for code-bundle reviews."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-withzero-annotation-review-session-creator-ce96cf76/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)