/conversations.history - Slack Web API

Fetches a conversation's history of messages and events.

{ "has_more": true, "messages": [ { "text": "I find you punny and would like to smell your nose letter", "ts": "1512085950.000216", "type": "message", "user": "U012AB3CDE" }, { "text": "What, you want to smell my shoes better?", "ts": "1512104434.000490", "type": "message", "user": "U061F7AUR" } ], "ok": true, "pin_count": 0, "response_metadata": { "next_cursor": "bmV4dF90czoxNTEyMDg1ODYxMDAwNTQz" } }

Request

Query Params

token

string

optional

Authentication token. Requires scope: conversations:history

channel

string

optional

Conversation ID to fetch history for.

latest

number

optional

End of time range of messages to include in results.

oldest

number

optional

Start of time range of messages to include in results.

inclusive

string

optional

Include messages with latest or oldest timestamp in results only when either timestamp is specified.

limit

integer

optional

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

optional

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

🟢200Typical success response containing a channel's messages

application/json

Body

Schema for successful response from conversations.history method

channel_actions_count

integer

required

channel_actions_ts

array [anyOf]

required

integer

optional

null

optional

has_more

boolean

required

messages

array[object (Message object) {41}]

required

>= 1 items

attachments

array [object {6}]

optional

>= 1 items

blocks

array [object {2}]

optional

This is a very loose definition, in the future, we'll populate this with deeper schema in this definition namespace.

bot_id

array [anyOf]

optional

bot_profile

object (Bot Profile Object)

optional

client_msg_id

string

optional

comment

object (File Comment Object)

optional

display_as_bot

boolean

optional

file

object (file object)

optional

files

array[object (file object) {70}]

optional

>= 1 items

icons

object

optional

inviter

string

optional

Match pattern:

^[UW][A-Z0-9]{2,}$

is_delayed_message

boolean

optional

is_intro

boolean

optional

is_starred

boolean

optional

last_read

string

optional

Match pattern:

^\d{10}\.\d{6}$

latest_reply

string

optional

Match pattern:

^\d{10}\.\d{6}$

name

string

optional

old_name

string

optional

parent_user_id

string

optional

Match pattern:

^[UW][A-Z0-9]{2,}$

permalink

string <uri>

optional

pinned_to

array[string]

optional

purpose

string

optional

reactions

array[object (Reaction object) {4}]

optional

reply_count

integer

optional

reply_users

array[string]

optional

>= 1 items

reply_users_count

integer

optional

source_team

string

optional

Match pattern:

^[TE][A-Z0-9]{8,}$

subscribed

boolean

optional

subtype

string

optional

team

string

optional

Match pattern:

^[TE][A-Z0-9]{8,}$

text

string

required

thread_ts

string

optional

Match pattern:

^\d{10}\.\d{6}$

topic

string

optional

string

required

Match pattern:

^\d{10}\.\d{6}$

type

string

required

unread_count

integer

optional

upload

boolean

optional

user

string

optional

Match pattern:

^[UW][A-Z0-9]{2,}$

user_profile

object (objs_user_profile_short)

optional

user_team

string

optional

Match pattern:

^[TE][A-Z0-9]{8,}$

username

string

optional

enum<boolean>

required

Allowed value:

true

pin_count

integer

required

🔴500Typical error response