Queues a Books Review run for a period (period_from to period_to, default this month; one date alone reads as on GET /v1/books-review) and depth (profile, default month_end), as the review page's Run, and answers 202 with status running, its correlation_key, period and profile; read the result with GET /v1/books-review once it is completed. The checks only read the books: a run writes its own results, its AI summary and history, never a journal, and the run is checked against the person's permissions again when it starts. When the company's Books Review schedule has email_after_manual_runs on, a finished run is also emailed to the schedule's recipients. One run at a time per company: while one is in flight a new start is a 409 books_review_run_in_progress with the running one's correlation_key in error.fields. A few runs per company and API client are admitted every five minutes (3 by default); past that the answer is 429 with Retry-After. Requires an Idempotency-Key: the same key and request replays the same 202 and never starts a second run. Requires the books-review:action OAuth scope with view_books_review and resolve_books_review.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
