Hanzo AI
OpenapiProvider

Search slack

Answers a workspace question: POST /v1/provider/slack/search.

POST /v1/provider/slack/search

Addresshttps://api.hanzo.ai/v1/provider/slack/search
MethodPOST
Operationpost_provider_slack_search
AuthAuthorization: Bearer $HANZO_API_KEY

Answers a workspace question: POST /v1/provider/slack/search.

Slack's search.messages wants a USER token for a person's own view of a workspace; a bot token searches what the app can see. Whichever the install granted, the token custodied for this org is the one sent.

Request

3 fields, body application/json (required).

FieldInTypeRequiredDescription
countbodyinteger (int64)Count bounds the page, 1-100.
pagebodyinteger (int64)Page is the 1-based page of results.
querybodystringQuery is Slack's own search syntax — bare words, or in:#channel, from:@someone, before:2026-09-01, has:link.

Response

StatusBodyMeaning
200provider.slackSearchOutok
defaultproblem-detailsrefused

200 body — 11 fields.

FieldInTypeAlwaysDescription
matchesbodyprovider.slackSearchHit[]Matches are this page's hits, most relevant first.
matches[].channelbodystringChannel is the conversation ID the match sits in.
matches[].channel_namebodystringChannelName is that conversation's name, when Slack reports one.
matches[].permalinkbodystringPermalink addresses the message in a browser.
matches[].textbodystringText is the matching message's text.
matches[].tsbodystringTS is the message's exact Slack timestamp, the handle for replying to or reacting to it.
matches[].userbodystringUser is the author's Slack user ID.
matches[].usernamebodystringUsername is the author's display name, when Slack reports one.
pagebodyinteger (int64)Page is the page these matches came from.
pagesbodyinteger (int64)Pages is how many pages the query has in total.
totalbodyinteger (int64)Total is how many messages matched, across every page.

Failure carries the platform error shape — see Errors.

Examples

hanzo provider slack search

Provider API · All Hanzo APIs · Interactive reference

How is this guide?

On this page