Slack Web API

/conversations.replies

GET

conversations

Retrieve a thread of messages posted to a conversation

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://slack.com/api/conversations.replies'

Response Example

200 - response

{
    "has_more": true,
    "messages": [
        {
            "last_read": "1484678597.521003",
            "reply_count": 3,
            "subscribed": true,
            "text": "island",
            "thread_ts": "1482960137.003543",
            "ts": "1482960137.003543",
            "type": "message",
            "unread_count": 0,
            "user": "U061F7AUR"
        },
        {
            "parent_user_id": "U061F7AUR",
            "text": "one island",
            "thread_ts": "1482960137.003543",
            "ts": "1483037603.017503",
            "type": "message",
            "user": "U061F7AUR"
        },
        {
            "parent_user_id": "U061F7AUR",
            "text": "two island",
            "thread_ts": "1482960137.003543",
            "ts": "1483051909.018632",
            "type": "message",
            "user": "U061F7AUR"
        },
        {
            "parent_user_id": "U061F7AUR",
            "text": "three for the land",
            "thread_ts": "1482960137.003543",
            "ts": "1483125339.020269",
            "type": "message",
            "user": "U061F7AUR"
        }
    ],
    "ok": true,
    "response_metadata": {
        "next_cursor": "bmV4dF90czoxNDg0Njc4MjkwNTE3MDkx"
    }
}

Request

Query Params

token

string

optional

Authentication token. Requires scope: conversations:history

channel

string

optional

Conversation ID to fetch thread from.

number

optional

Unique identifier of a thread's parent message. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message.

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

application/json

Body

Schema for successful response from conversations.replies method

has_more

boolean

optional

messages

array [array]

required

optional

enum<boolean>

required

Allowed value:

true

🔴500Typical error response

/conversations.rename

/conversations.setPurpose