search_messages - Charter Docs

GET

slack_search_messages.py

import asyncio

from charter.packs import slack

result = asyncio.run(slack.search_messages.ainvoke({"query": ...}))

Cannot run with slack.BOT: search.messages takes a user token only. With slack.USER, requires search:read. Pages by cursor: response_metadata.next_cursor is sent back as cursor.

Query parameters

Field	Type	Description
`query` *	`string`	Search query. Supports Slack’s search modifiers, e.g. ‘in:#engineering from:@ada after:2026-01-01’.
`count`	`integer`	Number of items to return per page. Maximum of 100. ≥ 1; ≤ 100; defaults to `20`
`page`	`integer`	Page number of results to return. ≥ 1; ≤ 100; defaults to `1`
`cursor`	`string`	Use this when getting results with cursormark pagination. Set to ’*’ for the first call and use the value of next_cursor thereafter.
`sort`	SearchSort	Return matches sorted by either ‘score’ or ‘timestamp’.
`sortDir`	SearchSortDir	Change sort direction to ascending (‘asc’) or descending (‘desc’).
`highlight`	`boolean`	Pass a value to enable query highlight markers.
`teamId`	`string`	Encoded team id to search in. Required if the token belongs to an org-wide app.

​Query parameters

Query parameters