conversations history

GET {{baseUrl}}/conversations.history?channel=<string>&latest=<number>&oldest=<number>&inclusive=<boolean>&limit=<integer>&cursor=<string>

Fetches a conversation's history of messages and events.

Request Params

KeyDatatypeRequiredDescription
channelstringConversation ID to fetch history for.
lateststringEnd of time range of messages to include in results.
oldeststringStart of time range of messages to include in results.
inclusivestringInclude messages with latest or oldest timestamp in results only when either timestamp is specified.
limitstringThe maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached.
cursorstringPaginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection. See pagination for more detail.

RESPONSES

status: OK

{&quot;ok&quot;:&quot;\u003cboolean\u003e&quot;,&quot;messages&quot;:[{&quot;text&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;ts&quot;:&quot;\u003cstring\u003e&quot;,&quot;attachments&quot;:[{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;fallback&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_bytes&quot;:&quot;\u003cinteger\u003e&quot;,&quot;image_height&quot;:&quot;\u003cinteger\u003e&quot;,&quot;image_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_width&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;blocks&quot;:[{&quot;type&quot;:&quot;\u003cstring\u003e&quot;},{&quot;type&quot;:&quot;\u003cstring\u003e&quot;}],&quot;bot_id&quot;:{},&quot;bot_profile&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated&quot;:&quot;\u003cinteger\u003e&quot;,&quot;app_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;icons&quot;:{&quot;image_36&quot;:&quot;\u003curi\u003e&quot;,&quot;image_48&quot;:&quot;\u003curi\u003e&quot;,&quot;image_72&quot;:&quot;\u003curi\u003e&quot;},&quot;team_id&quot;:&quot;\u003cstring\u003e&quot;},&quot;client_msg_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;comment&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;created&quot;:&quot;\u003cinteger\u003e&quot;,&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;user&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_intro&quot;:&quot;\u003cboolean\u003e&quot;,&quot;comment&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_starred&quot;:&quot;\u003cboolean\u003e&quot;,&quot;num_stars&quot;:&quot;\u003cinteger\u003e&quot;,&quot;pinned_info&quot;:&quot;\u003cobject\u003e&quot;,&quot;pinned_to&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;reactions&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;}]},&quot;display_as_bot&quot;:&quot;\u003cboolean\u003e&quot;,&quot;file&quot;:{&quot;channels&quot;:[&quot;\u003cstring\u003e&quot;],&quot;comments_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;created&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_delete&quot;:&quot;\u003cinteger\u003e&quot;,&quot;display_as_bot&quot;:&quot;\u003cboolean\u003e&quot;,&quot;editable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;editor&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_url&quot;:&quot;\u003curi\u003e&quot;,&quot;filetype&quot;:&quot;\u003cstring\u003e&quot;,&quot;groups&quot;:[&quot;\u003cstring\u003e&quot;],&quot;has_rich_preview&quot;:&quot;\u003cboolean\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_exif_rotation&quot;:&quot;\u003cinteger\u003e&quot;,&quot;ims&quot;:[&quot;\u003cstring\u003e&quot;],&quot;is_external&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_public&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_starred&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_tombstoned&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_editor&quot;:&quot;\u003cstring\u003e&quot;,&quot;mimetype&quot;:&quot;\u003cstring\u003e&quot;,&quot;mode&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;non_owner_editable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;num_stars&quot;:&quot;\u003cinteger\u003e&quot;,&quot;original_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;original_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;permalink&quot;:&quot;\u003curi\u003e&quot;,&quot;permalink_public&quot;:&quot;\u003curi\u003e&quot;,&quot;pinned_info&quot;:&quot;\u003cobject\u003e&quot;,&quot;pinned_to&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;pretty_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;preview&quot;:&quot;\u003cstring\u003e&quot;,&quot;public_url_shared&quot;:&quot;\u003cboolean\u003e&quot;,&quot;reactions&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;shares&quot;:{&quot;private&quot;:{},&quot;public&quot;:{}},&quot;size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;source_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumb_1024&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_1024_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_1024_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_160&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_360&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_360_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_360_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_480&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_480_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_480_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_64&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_720&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_720_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_720_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_80&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_800&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_800_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_800_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_960&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_960_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_960_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_tiny&quot;:&quot;\u003cstring\u003e&quot;,&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated&quot;:&quot;\u003cinteger\u003e&quot;,&quot;url_private&quot;:&quot;\u003curi\u003e&quot;,&quot;url_private_download&quot;:&quot;\u003curi\u003e&quot;,&quot;user&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;username&quot;:&quot;\u003cstring\u003e&quot;},&quot;files&quot;:[{&quot;channels&quot;:[&quot;\u003cstring\u003e&quot;],&quot;comments_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;created&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_delete&quot;:&quot;\u003cinteger\u003e&quot;,&quot;display_as_bot&quot;:&quot;\u003cboolean\u003e&quot;,&quot;editable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;editor&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_url&quot;:&quot;\u003curi\u003e&quot;,&quot;filetype&quot;:&quot;\u003cstring\u003e&quot;,&quot;groups&quot;:[&quot;\u003cstring\u003e&quot;],&quot;has_rich_preview&quot;:&quot;\u003cboolean\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_exif_rotation&quot;:&quot;\u003cinteger\u003e&quot;,&quot;ims&quot;:[&quot;\u003cstring\u003e&quot;],&quot;is_external&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_public&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_starred&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_tombstoned&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_editor&quot;:&quot;\u003cstring\u003e&quot;,&quot;mimetype&quot;:&quot;\u003cstring\u003e&quot;,&quot;mode&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;non_owner_editable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;num_stars&quot;:&quot;\u003cinteger\u003e&quot;,&quot;original_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;original_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;permalink&quot;:&quot;\u003curi\u003e&quot;,&quot;permalink_public&quot;:&quot;\u003curi\u003e&quot;,&quot;pinned_info&quot;:&quot;\u003cobject\u003e&quot;,&quot;pinned_to&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;pretty_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;preview&quot;:&quot;\u003cstring\u003e&quot;,&quot;public_url_shared&quot;:&quot;\u003cboolean\u003e&quot;,&quot;reactions&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;shares&quot;:{&quot;private&quot;:{},&quot;public&quot;:{}},&quot;size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;source_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumb_1024&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_1024_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_1024_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_160&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_360&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_360_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_360_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_480&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_480_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_480_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_64&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_720&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_720_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_720_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_80&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_800&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_800_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_800_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_960&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_960_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_960_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_tiny&quot;:&quot;\u003cstring\u003e&quot;,&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated&quot;:&quot;\u003cinteger\u003e&quot;,&quot;url_private&quot;:&quot;\u003curi\u003e&quot;,&quot;url_private_download&quot;:&quot;\u003curi\u003e&quot;,&quot;user&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;username&quot;:&quot;\u003cstring\u003e&quot;}],&quot;icons&quot;:{&quot;emoji&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_64&quot;:&quot;\u003curi\u003e&quot;},&quot;inviter&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_delayed_message&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_intro&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_starred&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_read&quot;:&quot;\u003cstring\u003e&quot;,&quot;latest_reply&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;old_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;permalink&quot;:&quot;\u003curi\u003e&quot;,&quot;pinned_to&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;purpose&quot;:&quot;\u003cstring\u003e&quot;,&quot;reactions&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;reply_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;reply_users&quot;:[&quot;\u003cstring\u003e&quot;],&quot;reply_users_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;source_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;subscribed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;subtype&quot;:&quot;\u003cstring\u003e&quot;,&quot;team&quot;:&quot;\u003cstring\u003e&quot;,&quot;thread_ts&quot;:&quot;\u003cstring\u003e&quot;,&quot;topic&quot;:&quot;\u003cstring\u003e&quot;,&quot;unread_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;upload&quot;:&quot;\u003cboolean\u003e&quot;,&quot;user&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_profile&quot;:{&quot;avatar_hash&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_72&quot;:&quot;\u003curi\u003e&quot;,&quot;first_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;real_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;team&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_restricted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_ultra_restricted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;display_name_normalized&quot;:&quot;\u003cstring\u003e&quot;,&quot;real_name_normalized&quot;:&quot;\u003cstring\u003e&quot;},&quot;user_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;username&quot;:&quot;\u003cstring\u003e&quot;}],&quot;has_more&quot;:&quot;\u003cboolean\u003e&quot;,&quot;pin_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;channel_actions_ts&quot;:{},&quot;channel_actions_count&quot;:&quot;\u003cinteger\u003e&quot;}