Search Ticket Messages
Search messages across tickets with filters for workspace, ticket, author, author role, and creation time range. This is the single-request alternative to listing tickets and calling List Ticket Messages per ticket — e.g. all messages authored by given workspace members in a given week, regardless of when their tickets were opened. Searches messages on non-archived tickets the caller can view; results are ordered newest first.
Authentication and permissions
Token requirements: User-based token (OAuth) or Organization-scoped API key or Workspace-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
- Search specified workspaces: Supply team_ids. Every requested workspace must be allowed. Internal notes require permission to view internal notes on the owning workspace.
- Search the organization: Omitting team_ids searches the organization and requires an organization-scoped key. A signed-in user instead searches only the workspaces they belong to where they can view tickets. Internal notes require permission to view internal notes on the owning workspace.
Authorizations
Body
Optional. Filter to messages on tickets in these workspaces. The caller must be able to view tickets on every listed workspace, or the whole request is denied, so do not pass every workspace from List Workspaces. If not provided, a signed-in user searches the workspaces they belong to and can view tickets on; an API key with organization-wide ticket access searches every workspace. List explicitly any workspace you can view only through an organization role, and the allowed workspaces of a workspace-restricted API key.

