{"uid":"cap_YMPiMPhBVov9BQurOY7-j","slug":"agents-withzero-xyz-withzero-annotation-review-session-creator-ce96cf76","name":"WithZero Annotation Review Session Creator","description":"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.","url":"https://agents.withzero.xyz/api/v1/annotate/reviews?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.020000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$0.020000/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.020000","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.020000","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h3qC44UV7Zg8RZXg25xu0","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.020000","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":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Live webpage UI feedback session","prompt":"Create an annotation review session for https://staging.mycompany.com/landing-page so our designer can leave comments directly on the page — give me a link I can send them."},{"title":"Static bundle review with webhook","prompt":"I have a base64-encoded zip of my static site with index.html as the entry point. Set up an annotation session for it and ping https://hooks.myteam.com/annotation-done when the reviewer submits, so I can pick up their notes automatically."},{"title":"Pre-launch QA annotation round","prompt":"Start a review session for the zip bundle I'm uploading — entry file is dashboard.html — and give me both the reviewer share link and the bundle download URL so I can archive the source alongside the feedback."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:38:17.155Z","isFirstParty":true,"canonicalSlug":"agents-withzero-xyz-withzero-annotation-review-session-creator-ce96cf76"}