conversations_replies

GET /conversations.replies

Copy endpoint

https://slack.com/api

Retrieve a thread of messages posted to a conversation

Parameters

query Query Parameters

Name	Type
`token` Authentication token. Requires scope: `conversations:history`	string
`channel` Conversation ID to fetch thread from.	string
`ts` 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.	number
`latest` End of time range of messages to include in results.	number
`oldest` Start of time range of messages to include in results.	number
`inclusive` Include messages with latest or oldest timestamp in results only when either timestamp is specified.	boolean
`limit` 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.	number
`cursor` 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.	string

Responses

200 application/json

Typical success response

{ has_more?: boolean;messages: ({
last_read?:

DefsTs

type DefsTs = `${string}.${string}`

;
latest_reply?:

DefsTs

type DefsTs = `${string}.${string}`

;
reply_count: number;
reply_users?:

DefsUserId

type DefsUserId = string

[];
reply_users_count?: number;
source_team?:

DefsTeam

type DefsTeam = string

;
subscribed: boolean;
team?:

DefsTeam

type DefsTeam = string

;
text: string;
thread_ts:

DefsTs

type DefsTs = `${string}.${string}`

;
ts:

DefsTs

type DefsTs = `${string}.${string}`

;
type: string;
unread_count?: number;
user:

DefsUserId

type DefsUserId = string

;
user_profile?:

ObjsUserProfileShort

interface ObjsUserProfileShort {
avatar_hash: string;
display_name: string;
display_name_normalized?: string;
first_name: string | null;
image_72: string;
is_restricted: boolean;
is_ultra_restricted: boolean;
name: string;
real_name: string;
real_name_normalized?: string;
team: DefsWorkspaceId;
}

;
user_team?:

DefsTeam

type DefsTeam = string

;
} | {
is_starred?: boolean;
parent_user_id:

DefsUserId

type DefsUserId = string

;
source_team?:

DefsTeam

type DefsTeam = string

;
team?:

DefsTeam

type DefsTeam = string

;
text: string;
thread_ts:

DefsTs

type DefsTs = `${string}.${string}`

;
ts:

DefsTs

type DefsTs = `${string}.${string}`

;
type: string;
user:

DefsUserId

type DefsUserId = string

;
user_profile?:

ObjsUserProfileShort

;
user_team?:

DefsTeam

type DefsTeam = string

;
})[][];ok:

DefsOkTrue

type DefsOkTrue = true

; }

default application/json

Typical error response

{
callstack?: string;
error: "missing_scope" | "channel_not_found" | "thread_not_found" | "not_authed" | "invalid_auth" | "account_inactive" | "invalid_arg_name" | "invalid_array_arg" | "invalid_charset" | "invalid_form_data" | "invalid_post_type" | "missing_post_type" | "team_added_to_org" | "invalid_json" | "json_not_object" | "request_timeout" | "upgrade_required";
needed?: string;
ok:

DefsOkFalse

type DefsOkFalse = false

;
provided?: string;
}