recall_events
Reads events by time window or keyword.
Default limit 50, maximum 200.
- Tool name
- recall_events
- Group
- Memory
- Risk
- none
- Needs approval
- never
- Approval rule
- Read only.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| since | string | No | Start of the time window, ISO-8601 UTC. | ||
| until | string | No | End of the time window, ISO-8601 UTC. | ||
| query | string | No | Words to look for. | ||
| limit | integer | No | Maximum number of results. |
Returns
A list of events.
Example (made up for this page)
{}2026-10-01T09:00Z note: demo startedSide effects
- none
How it can fail
| When | What the agent sees |
|---|---|
| A time value is not ISO-8601 | An error text |
See also:Memory tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.