idstring uuid required
UUIDv7, lowercase canonical form.
conversation_idstring required
state'pending' | 'answered' | 'canceled' required
toolstring nullable required
The tool the agent wants to use, as its harness names it (Bash, Edit, apply_patch, an MCP tool). Null when the harness does not say.
kindstring nullable required
What the tool does when the harness says: execute, edit, read, delete, move, search, fetch or other.
titlestring required
What the agent wants to do, on one line (“Run npm test”).
detailstring required
The command, path, URL or input the request is about; empty when the title says it all.
optionsstring[] required
The decisions this request takes. Empty: answer it where the agent runs (its terminal or app).
decision'allow_once' | 'allow_always' | 'deny' nullable required
answered_via'api' | 'agent' nullable required
created_atstring date-time required
RFC 3339 UTC timestamp with Z.
answered_atstring date-time nullable required
RFC 3339 UTC timestamp with Z.
answersobject nullable
The answer to each question, keyed by its question text: an option label or your own words; a list of labels for a multi_select question.