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
Key | Datatype | Required | Description |
---|---|---|---|
channel | string | Conversation ID to fetch history for. | |
latest | string | End of time range of messages to include in results. | |
oldest | string | Start of time range of messages to include in results. | |
inclusive | string | Include messages with latest or oldest timestamp in results only when either timestamp is specified. | |
limit | string | The 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. | |
cursor | string | Paginate 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
{"ok":"\u003cboolean\u003e","messages":[{"text":"\u003cstring\u003e","type":"\u003cstring\u003e","ts":"\u003cstring\u003e","attachments":[{"id":"\u003cinteger\u003e","fallback":"\u003cstring\u003e","image_bytes":"\u003cinteger\u003e","image_height":"\u003cinteger\u003e","image_url":"\u003cstring\u003e","image_width":"\u003cinteger\u003e"}],"blocks":[{"type":"\u003cstring\u003e"},{"type":"\u003cstring\u003e"}],"bot_id":{},"bot_profile":{"id":"\u003cstring\u003e","deleted":"\u003cboolean\u003e","name":"\u003cstring\u003e","updated":"\u003cinteger\u003e","app_id":"\u003cstring\u003e","icons":{"image_36":"\u003curi\u003e","image_48":"\u003curi\u003e","image_72":"\u003curi\u003e"},"team_id":"\u003cstring\u003e"},"client_msg_id":"\u003cstring\u003e","comment":{"id":"\u003cstring\u003e","created":"\u003cinteger\u003e","timestamp":"\u003cinteger\u003e","user":"\u003cstring\u003e","is_intro":"\u003cboolean\u003e","comment":"\u003cstring\u003e","is_starred":"\u003cboolean\u003e","num_stars":"\u003cinteger\u003e","pinned_info":"\u003cobject\u003e","pinned_to":["\u003cstring\u003e","\u003cstring\u003e"],"reactions":[{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"},{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"}]},"display_as_bot":"\u003cboolean\u003e","file":{"channels":["\u003cstring\u003e"],"comments_count":"\u003cinteger\u003e","created":"\u003cinteger\u003e","date_delete":"\u003cinteger\u003e","display_as_bot":"\u003cboolean\u003e","editable":"\u003cboolean\u003e","editor":"\u003cstring\u003e","external_id":"\u003cstring\u003e","external_type":"\u003cstring\u003e","external_url":"\u003curi\u003e","filetype":"\u003cstring\u003e","groups":["\u003cstring\u003e"],"has_rich_preview":"\u003cboolean\u003e","id":"\u003cstring\u003e","image_exif_rotation":"\u003cinteger\u003e","ims":["\u003cstring\u003e"],"is_external":"\u003cboolean\u003e","is_public":"\u003cboolean\u003e","is_starred":"\u003cboolean\u003e","is_tombstoned":"\u003cboolean\u003e","last_editor":"\u003cstring\u003e","mimetype":"\u003cstring\u003e","mode":"\u003cstring\u003e","name":"\u003cstring\u003e","non_owner_editable":"\u003cboolean\u003e","num_stars":"\u003cinteger\u003e","original_h":"\u003cinteger\u003e","original_w":"\u003cinteger\u003e","permalink":"\u003curi\u003e","permalink_public":"\u003curi\u003e","pinned_info":"\u003cobject\u003e","pinned_to":["\u003cstring\u003e","\u003cstring\u003e"],"pretty_type":"\u003cstring\u003e","preview":"\u003cstring\u003e","public_url_shared":"\u003cboolean\u003e","reactions":[{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"},{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"}],"shares":{"private":{},"public":{}},"size":"\u003cinteger\u003e","source_team":"\u003cstring\u003e","state":"\u003cstring\u003e","thumb_1024":"\u003curi\u003e","thumb_1024_h":"\u003cinteger\u003e","thumb_1024_w":"\u003cinteger\u003e","thumb_160":"\u003curi\u003e","thumb_360":"\u003curi\u003e","thumb_360_h":"\u003cinteger\u003e","thumb_360_w":"\u003cinteger\u003e","thumb_480":"\u003curi\u003e","thumb_480_h":"\u003cinteger\u003e","thumb_480_w":"\u003cinteger\u003e","thumb_64":"\u003curi\u003e","thumb_720":"\u003curi\u003e","thumb_720_h":"\u003cinteger\u003e","thumb_720_w":"\u003cinteger\u003e","thumb_80":"\u003curi\u003e","thumb_800":"\u003curi\u003e","thumb_800_h":"\u003cinteger\u003e","thumb_800_w":"\u003cinteger\u003e","thumb_960":"\u003curi\u003e","thumb_960_h":"\u003cinteger\u003e","thumb_960_w":"\u003cinteger\u003e","thumb_tiny":"\u003cstring\u003e","timestamp":"\u003cinteger\u003e","title":"\u003cstring\u003e","updated":"\u003cinteger\u003e","url_private":"\u003curi\u003e","url_private_download":"\u003curi\u003e","user":"\u003cstring\u003e","user_team":"\u003cstring\u003e","username":"\u003cstring\u003e"},"files":[{"channels":["\u003cstring\u003e"],"comments_count":"\u003cinteger\u003e","created":"\u003cinteger\u003e","date_delete":"\u003cinteger\u003e","display_as_bot":"\u003cboolean\u003e","editable":"\u003cboolean\u003e","editor":"\u003cstring\u003e","external_id":"\u003cstring\u003e","external_type":"\u003cstring\u003e","external_url":"\u003curi\u003e","filetype":"\u003cstring\u003e","groups":["\u003cstring\u003e"],"has_rich_preview":"\u003cboolean\u003e","id":"\u003cstring\u003e","image_exif_rotation":"\u003cinteger\u003e","ims":["\u003cstring\u003e"],"is_external":"\u003cboolean\u003e","is_public":"\u003cboolean\u003e","is_starred":"\u003cboolean\u003e","is_tombstoned":"\u003cboolean\u003e","last_editor":"\u003cstring\u003e","mimetype":"\u003cstring\u003e","mode":"\u003cstring\u003e","name":"\u003cstring\u003e","non_owner_editable":"\u003cboolean\u003e","num_stars":"\u003cinteger\u003e","original_h":"\u003cinteger\u003e","original_w":"\u003cinteger\u003e","permalink":"\u003curi\u003e","permalink_public":"\u003curi\u003e","pinned_info":"\u003cobject\u003e","pinned_to":["\u003cstring\u003e","\u003cstring\u003e"],"pretty_type":"\u003cstring\u003e","preview":"\u003cstring\u003e","public_url_shared":"\u003cboolean\u003e","reactions":[{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"},{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"}],"shares":{"private":{},"public":{}},"size":"\u003cinteger\u003e","source_team":"\u003cstring\u003e","state":"\u003cstring\u003e","thumb_1024":"\u003curi\u003e","thumb_1024_h":"\u003cinteger\u003e","thumb_1024_w":"\u003cinteger\u003e","thumb_160":"\u003curi\u003e","thumb_360":"\u003curi\u003e","thumb_360_h":"\u003cinteger\u003e","thumb_360_w":"\u003cinteger\u003e","thumb_480":"\u003curi\u003e","thumb_480_h":"\u003cinteger\u003e","thumb_480_w":"\u003cinteger\u003e","thumb_64":"\u003curi\u003e","thumb_720":"\u003curi\u003e","thumb_720_h":"\u003cinteger\u003e","thumb_720_w":"\u003cinteger\u003e","thumb_80":"\u003curi\u003e","thumb_800":"\u003curi\u003e","thumb_800_h":"\u003cinteger\u003e","thumb_800_w":"\u003cinteger\u003e","thumb_960":"\u003curi\u003e","thumb_960_h":"\u003cinteger\u003e","thumb_960_w":"\u003cinteger\u003e","thumb_tiny":"\u003cstring\u003e","timestamp":"\u003cinteger\u003e","title":"\u003cstring\u003e","updated":"\u003cinteger\u003e","url_private":"\u003curi\u003e","url_private_download":"\u003curi\u003e","user":"\u003cstring\u003e","user_team":"\u003cstring\u003e","username":"\u003cstring\u003e"}],"icons":{"emoji":"\u003cstring\u003e","image_64":"\u003curi\u003e"},"inviter":"\u003cstring\u003e","is_delayed_message":"\u003cboolean\u003e","is_intro":"\u003cboolean\u003e","is_starred":"\u003cboolean\u003e","last_read":"\u003cstring\u003e","latest_reply":"\u003cstring\u003e","name":"\u003cstring\u003e","old_name":"\u003cstring\u003e","parent_user_id":"\u003cstring\u003e","permalink":"\u003curi\u003e","pinned_to":["\u003cstring\u003e","\u003cstring\u003e"],"purpose":"\u003cstring\u003e","reactions":[{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"},{"name":"\u003cstring\u003e","users":["\u003cstring\u003e","\u003cstring\u003e"],"count":"\u003cinteger\u003e"}],"reply_count":"\u003cinteger\u003e","reply_users":["\u003cstring\u003e"],"reply_users_count":"\u003cinteger\u003e","source_team":"\u003cstring\u003e","subscribed":"\u003cboolean\u003e","subtype":"\u003cstring\u003e","team":"\u003cstring\u003e","thread_ts":"\u003cstring\u003e","topic":"\u003cstring\u003e","unread_count":"\u003cinteger\u003e","upload":"\u003cboolean\u003e","user":"\u003cstring\u003e","user_profile":{"avatar_hash":"\u003cstring\u003e","image_72":"\u003curi\u003e","first_name":"\u003cstring\u003e","real_name":"\u003cstring\u003e","display_name":"\u003cstring\u003e","team":"\u003cstring\u003e","name":"\u003cstring\u003e","is_restricted":"\u003cboolean\u003e","is_ultra_restricted":"\u003cboolean\u003e","display_name_normalized":"\u003cstring\u003e","real_name_normalized":"\u003cstring\u003e"},"user_team":"\u003cstring\u003e","username":"\u003cstring\u003e"}],"has_more":"\u003cboolean\u003e","pin_count":"\u003cinteger\u003e","channel_actions_ts":{},"channel_actions_count":"\u003cinteger\u003e"}