Get Timeline
get_timelineThe user's days in one read: calendar events, Moments (lived stories) and Food Diary entries for a civil date range in the account timezone (max 92 days; default today). A food entry's calendar mirror is listed once, under food. Text the connection may not see is redacted as in get_events. Each record keeps its id and inspect_url where it has a page. ($0.05; API key required)
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_timeline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Optional ISO instant to read "today" at (defaults to now). | |
| to | No | Last civil day, YYYY-MM-DD, inclusive. | |
| date | No | Alias for from (one day). | |
| from | No | First civil day, YYYY-MM-DD, in the account timezone. Alone = that one day. Default: today. | |
| timezone | No | Optional IANA zone of the user's device (e.g. Asia/Singapore). Used only when the account has no zone set; the profile zone wins. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| food | Yes | ||
| from | Yes | ||
| today | No | ||
| counts | No | Rows returned per section. | |
| events | Yes | ||
| moments | Yes | ||
| timezone | Yes | ||
| truncated | No | true per section when more rows exist than were returned. | |
| unavailable | No |