# Create Web Page Annotation Review Session

> Create Web Page Annotation Review Session is a paid API for AI agents from annotate.withzero.xyz, paid per call via MPP, $0.05/call, status unknown (last checked 2026-09-15).

Creates a shareable review session for a given URL so human reviewers can annotate it with click-to-pin comments, returning a share link and session ID.

## Facts

- Endpoint: POST https://annotate.withzero.xyz/api/v1/reviews
- Price: $0.05/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: annotate.withzero.xyz
- Website: https://annotate.withzero.xyz
- Canonical page: https://www.zero.xyz/c/annotate-withzero-xyz-create-web-page-annotation-review-session-3aa68488
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wt2vpSDFPkIuyZsRICM8S

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 annotate-withzero-xyz-create-web-page-annotation-review-session-3aa68488 -d '<json body>'
```

Example prompt: Set up a web page annotation review session for https://myapp.com/landing-page and notify me at https://myserver.com/webhook when the reviewer submits their comments.

## When to prefer this

Use this endpoint when you need a human to visually annotate or review a specific web page with click-to-pin comments. It is the right choice when you want to collect structured human feedback on a live URL and receive results via webhook, rather than running automated analysis.

## Known failure modes

- Invalid or unreachable URL provided — returns 400 with validation error
- Invalid callbackUrl format — returns 400 with schema validation error
- Service unavailable — returns 503
- Rate limit exceeded — returns 429
- Payment not provided or insufficient — returns 402

## 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 with a UUID reviewId for the created session and a shareUrl that can be sent to a human reviewer so they can open the page and leave click-to-pin annotations. The agent can poll or await a webhook callback at the provided callbackUrl to receive the full review JSON when the human submits.

## Example request

```json
{
 "url": "https://example.com/sample-page",
 "callbackUrl": "https://webhook.example.com/reviews/callback"
}
```

## 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/annotate-withzero-xyz-create-web-page-annotation-review-session-3aa68488/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from annotate.withzero.xyz](https://www.zero.xyz/host/annotate.withzero.xyz/llms.txt)