message_replies

message_replies returns every message that directly replies to one message. Use it to show a “replies” view. Replies to replies are not included.

Request

{
  "cmd": "message_replies",
  "channel": "general",
  "id": "0b6c7f55-4a0f-4f7e-9a53-1a8b0d3d52c1"
}

Field	Type	Required	Description
`channel`	string	One of `channel` or `thread_id`	Channel name.
`thread_id`	string	One of `channel` or `thread_id`	Thread ID. If you also send `channel`, it must be the thread’s parent.
`id`	string	Yes	ID of the message whose replies you want.

Response

{
  "cmd": "message_replies",
  "channel": "general",
  "val": [
    {
      "id": "7d0e4c1a-5b8f-4b0e-8f55-2d3c9a61e7b4",
      "user": "alice",
      "author_id": "<alice's user ID>",
      "timestamp": 1788940000.31,
      "content": "Release notes are up: https://example.com/changelog",
      "reply_to": {
        "user": "bob",
        "id": "0b6c7f55-4a0f-4f7e-9a53-1a8b0d3d52c1",
        "preview": "When do the release notes go out?"
      },
      "ping": true,
      "pings": { "replies": ["bob"] }
    }
  ]
}

val is an array of message objects. It is empty when nothing replies to the message.
An entry is null when its author is severed from you. Skip those entries.
There is no paging. The server reads the whole channel or thread history to answer, so avoid calling it in a loop.
A thread response has thread_id, and channel is the thread’s parent.

Permissions

You must be able to view the channel, or the thread’s parent channel.

Errors

`val`	When
`Channel not found`	The channel doesn’t exist, or you sent neither `channel` nor `thread_id`.
`Thread not found`	No thread has this ID.
`Thread does not belong to this channel`	`channel` is not the thread’s parent.
`You do not have permission to view this thread`	You can’t view the thread’s parent channel.
`Messages must be sent inside a thread in forum channels`	`channel` is a forum and you sent no `thread_id`.
`This channel does not support chat`	`channel` is a separator.
`Access denied to this channel`	You can’t view the channel.
`Message not found`	No message with this ID is in the channel or thread.

A validation message is returned when id is missing or empty.

See also