search_messages
Search message text across all dialogs or in one chat to locate specific information. Set a since-date to filter by time and limit to control result count.
Instructions
Search message text globally or in one chat; omit chat for a global search.
since_date: optional ISO 8601 cutoff (e.g. "2026-01-01"). Results default to
the last 7 days when omitted. Pass an explicit date to look further back; a very
old date effectively means all history. A value with no timezone is treated as UTC.
Global search (no chat) scans dialogs one at a time and stops once limit
results are collected, so results favor whichever dialogs are scanned first
rather than being ranked by relevance or recency across the whole account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat | No | ||
| limit | No | ||
| query | Yes | ||
| since_date | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |