API Reference / Request changes
Request changes
POST/api/v1/review/{id}/request-changes
Send a card back to the agent with feedback. A revised version returns to the queue.
curl -X POST -H "Authorization: Bearer $REVNU_API_TOKEN" \
-H "content-type: application/json" \
-d '{"text":"Shorter, and lead with the case study."}' \
https://revnu.com/api/v1/review/k97…/request-changesBody
text, required, up to 8,000 UTF-8 bytes. The agent revises within about 30 seconds and the new version lands as a fresh card.
Responses
200 { ok: true }. 409 invalid_action if the card no longer accepts it.
Agents: this page is also markdown at /docs/review-request-changes.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
`review:write`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.