history
Resolved requests, newest resolution first, with cursor pagination. history.keep_days/max_requests and best-effort history.max_bytes bound retained requests; history.files_keep_days can expire files while keeping history.
Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Next_cursor of the previous page
Page size, default 50, maximum 500
One or more of approved, denied, expired, cancelled, auto (rule or YOLO decision), dismissed (info notice), comma-separated
One or more agent names, comma-separated
Only requests with a preview of this type
Grouped history preview filter.
Attachments: any file, files, image, pdf, audio, or video preview
One or more request kinds: command, edit, review, question, info, custom, comma-separated
Case-insensitive search in title, summary, and cwd
Responses
Section titled “Responses”Retention for resolved requests (decision history). The daemon prunes at start and hourly; 0 disables a cap. Pending requests are never pruned.
object
Delete resolved requests older than this many days (0 = no age cap).
Keep at most this many resolved requests (0 = no count cap).
Best-effort live database/WAL/blob byte cap, excluding free database pages (0 = unlimited).
Remove files belonging only to resolutions older than N days (0 = request lifetime).
Invalid filter or cursor