Conversations
Conversations History
Fetches a conversation's history of messages and events.
Authorization
slackAuth channels:history, groups:history, im:history, mpim:historyAuthorizationBearer <token>
In: header
Scope: channels:history, groups:history, im:history, mpim:history
Query Parameters
token?string
Authentication token. Requires scope: conversations:history
channel?string
Conversation ID to fetch history for.
latest?number
End of time range of messages to include in results.
Format
doubleoldest?number
Start of time range of messages to include in results.
Format
doubleinclusive?boolean
Include messages with latest or oldest timestamp in results only when either timestamp is specified.
limit?integer
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.
Format
int32cursor?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.
Header Parameters
Content-Type*"application/x-www-form-urlencoded"
Value in
- "application/x-www-form-urlencoded"
Response Body
application/json
application/json
curl -X GET "https://example.com/conversations.history" \ -H "Content-Type: application/x-www-form-urlencoded"{ "channel_actions_count": 0, "channel_actions_ts": null, "has_more": true, "messages": [ { "attachments": [ { "fallback": "string", "id": 0, "image_bytes": 0, "image_height": 0, "image_url": "string", "image_width": 0 } ], "blocks": [ { "type": "string" } ], "bot_id": null, "bot_profile": { "app_id": "string", "deleted": true, "icons": { "image_36": "http://example.com", "image_48": "http://example.com", "image_72": "http://example.com" }, "id": "string", "name": "string", "team_id": "string", "updated": 0 }, "client_msg_id": "string", "comment": { "comment": "string", "created": 0, "id": "string", "is_intro": true, "is_starred": true, "num_stars": 0, "pinned_info": {}, "pinned_to": [ "string" ], "reactions": [ { "count": 0, "name": "string", "users": [ "string" ] } ], "timestamp": 0, "user": "string" }, "display_as_bot": true, "file": { "channels": [ "string" ], "comments_count": 0, "created": 0, "date_delete": 0, "display_as_bot": true, "editable": true, "editor": "string", "external_id": "string", "external_type": "string", "external_url": "http://example.com", "filetype": "string", "groups": [ "string" ], "has_rich_preview": true, "id": "string", "image_exif_rotation": 0, "ims": [ "string" ], "is_external": true, "is_public": true, "is_starred": true, "is_tombstoned": true, "last_editor": "string", "mimetype": "string", "mode": "string", "name": "string", "non_owner_editable": true, "num_stars": 0, "original_h": 0, "original_w": 0, "permalink": "http://example.com", "permalink_public": "http://example.com", "pinned_info": {}, "pinned_to": [ "string" ], "pretty_type": "string", "preview": "string", "public_url_shared": true, "reactions": [ { "count": 0, "name": "string", "users": [ "string" ] } ], "shares": { "private": null, "public": null }, "size": 0, "source_team": "string", "state": "string", "thumb_1024": "http://example.com", "thumb_1024_h": 0, "thumb_1024_w": 0, "thumb_160": "http://example.com", "thumb_360": "http://example.com", "thumb_360_h": 0, "thumb_360_w": 0, "thumb_480": "http://example.com", "thumb_480_h": 0, "thumb_480_w": 0, "thumb_64": "http://example.com", "thumb_720": "http://example.com", "thumb_720_h": 0, "thumb_720_w": 0, "thumb_80": "http://example.com", "thumb_800": "http://example.com", "thumb_800_h": 0, "thumb_800_w": 0, "thumb_960": "http://example.com", "thumb_960_h": 0, "thumb_960_w": 0, "thumb_tiny": "string", "timestamp": 0, "title": "string", "updated": 0, "url_private": "http://example.com", "url_private_download": "http://example.com", "user": "string", "user_team": "string", "username": "string" }, "files": [ { "channels": [ "string" ], "comments_count": 0, "created": 0, "date_delete": 0, "display_as_bot": true, "editable": true, "editor": "string", "external_id": "string", "external_type": "string", "external_url": "http://example.com", "filetype": "string", "groups": [ "string" ], "has_rich_preview": true, "id": "string", "image_exif_rotation": 0, "ims": [ "string" ], "is_external": true, "is_public": true, "is_starred": true, "is_tombstoned": true, "last_editor": "string", "mimetype": "string", "mode": "string", "name": "string", "non_owner_editable": true, "num_stars": 0, "original_h": 0, "original_w": 0, "permalink": "http://example.com", "permalink_public": "http://example.com", "pinned_info": {}, "pinned_to": [ "string" ], "pretty_type": "string", "preview": "string", "public_url_shared": true, "reactions": [ { "count": 0, "name": "string", "users": [ "string" ] } ], "shares": { "private": null, "public": null }, "size": 0, "source_team": "string", "state": "string", "thumb_1024": "http://example.com", "thumb_1024_h": 0, "thumb_1024_w": 0, "thumb_160": "http://example.com", "thumb_360": "http://example.com", "thumb_360_h": 0, "thumb_360_w": 0, "thumb_480": "http://example.com", "thumb_480_h": 0, "thumb_480_w": 0, "thumb_64": "http://example.com", "thumb_720": "http://example.com", "thumb_720_h": 0, "thumb_720_w": 0, "thumb_80": "http://example.com", "thumb_800": "http://example.com", "thumb_800_h": 0, "thumb_800_w": 0, "thumb_960": "http://example.com", "thumb_960_h": 0, "thumb_960_w": 0, "thumb_tiny": "string", "timestamp": 0, "title": "string", "updated": 0, "url_private": "http://example.com", "url_private_download": "http://example.com", "user": "string", "user_team": "string", "username": "string" } ], "icons": { "emoji": "string", "image_64": "http://example.com" }, "inviter": "string", "is_delayed_message": true, "is_intro": true, "is_starred": true, "last_read": "string", "latest_reply": "string", "name": "string", "old_name": "string", "parent_user_id": "string", "permalink": "http://example.com", "pinned_to": [ "string" ], "purpose": "string", "reactions": [ { "count": 0, "name": "string", "users": [ "string" ] } ], "reply_count": 0, "reply_users": [ "string" ], "reply_users_count": 0, "source_team": "string", "subscribed": true, "subtype": "string", "team": "string", "text": "string", "thread_ts": "string", "topic": "string", "ts": "string", "type": "string", "unread_count": 0, "upload": true, "user": "string", "user_profile": { "avatar_hash": "string", "display_name": "string", "display_name_normalized": "string", "first_name": "string", "image_72": "http://example.com", "is_restricted": true, "is_ultra_restricted": true, "name": "string", "real_name": "string", "real_name_normalized": "string", "team": "string" }, "user_team": "string", "username": "string" } ], "ok": "True", "pin_count": 0}