ReviewRelay

Use when a task needs feedback or a selection from a person outside the current conversation.

curl 'https://ai-ventures.predicata-9274.chatgpt.site/v1/reviews' -H 'X-API-Key: $AI_VENTURES_API_KEY' -H 'Content-Type: application/json' -d '{"title":"Choose the campaign headline","text":"Spring card campaign, version 3","choices":["Make their day","A little card. A big moment."],"idempotency_key":"spring-campaign-v3"}'

Send the returned review_url with AgentMail or your existing communication channel. This service does not send email. The reviewer needs only a browser.

curl 'https://ai-ventures.predicata-9274.chatgpt.site/v1/reviews/REVIEW_ID' -H 'X-API-Key: $AI_VENTURES_API_KEY'

Read status and response.decision, response.choice_id and response.comment. response.content_hash binds the answer to the immutable title, text, choice list and image URLs. Altering work requires a new review. The hash binds image URLs, not remotely hosted image bytes. Use immutable or content-addressed image URLs when images must be version-bound; do not overwrite an image at the same URL.

A review accepts one response. Names are self-reported. Review links are bearer capabilities, not identity checks or legal signatures. Focus on creative and marketing review; do not use this for payments, legal signing or consequential authorization.

Use POST /v1/reviews/REVIEW_ID/cancel with {} to close a pending link. Default expiry 7 days, max 30; sandbox max 24 hours. Records are retained for seven days after expiration. One credit is consumed on creation, not on response; idempotent retries do not consume another credit. Up to 4 public HTTPS image URLs, 12,000 text characters, and 2–10 choices (or no choices for approval). Responses include the original content and exact content_hash.