Reviews
List Reviews
List the reviews the caller can read, newest first.
GET
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive
403 mcp_not_enabled. See the preview overview.limit reviews, or none, and still have a cursor to the rest. Keep paging until cursor is null.
Authentication
Requires an API key, or an OAuth token withreviews:read.
Query parameters
string
Only reviews of this type:
playbook, instructions or counterparty_edits.string
Only reviews in this status:
queued, running, completed, failed or cancelled.string
Only reviews whose
file_ids include this file. A review lists its own copies of the files it reviewed, so pass an id from a review, not the id you started it with.string
Search the reviews as the Wordsmith app’s review search does, up to 200 characters. It matches the reviewed files’ names and content, not the review’s
name.string
The
cursor from the previous page. Omit it for the first page.integer
default:"20"
Reviews to read per page, from
1 to 100.Response
Returns200 with {"items": [...], "cursor": "..."}. cursor is null on the last page.