product:chat
Search roles
Searches mentionable roles (user-assignable + channel-assignable, built-in and custom) by name prefix for autocomplete
get/roles/search
Query parameters
querystring required
Case-insensitive name prefix to match against role names
limitinteger
Maximum number of roles to return (1-25, default 10)
name_gtstring
Return roles with names strictly greater than this cursor (for pagination)
role_type'user' | 'channel'
Optional filter: 'user' for user-assignable roles, 'channel' for channel-assignable roles. Omit to return both.
include_global_rolesboolean
When true, include cross-team operator roles whose name starts with 'global_'. Defaults to false.
Response
Successful response