Skip to content
handupbeta
Download

history

View as Markdown
GET
/v1/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.

cursor
string

Next_cursor of the previous page

limit
integer

Page size, default 50, maximum 500

outcome
string

One or more of approved, denied, expired, cancelled, auto (rule or YOLO decision), dismissed (info notice), comma-separated

agent
string

One or more agent names, comma-separated

type
string
Allowed values: text markdown code diff files command json html image video audio file pdf email

Only requests with a preview of this type

has

Grouped history preview filter.

string
Allowed values: attachments

Attachments: any file, files, image, pdf, audio, or video preview

kind
string

One or more request kinds: command, edit, review, question, info, custom, comma-separated

q
string

Case-insensitive search in title, summary, and cwd

Media typeapplication/json

Retention for resolved requests (decision history). The daemon prunes at start and hourly; 0 disables a cap. Pending requests are never pruned.

object
keep_days

Delete resolved requests older than this many days (0 = no age cap).

integer format: int32
default: 90
max_requests

Keep at most this many resolved requests (0 = no count cap).

integer format: int32
default: 2000
max_bytes

Best-effort live database/WAL/blob byte cap, excluding free database pages (0 = unlimited).

integer format: int64
0
files_keep_days

Remove files belonging only to resolutions older than N days (0 = request lifetime).

integer format: int32
0

Invalid filter or cursor