Messages
List a thread's replies
List the replies in the thread a message belongs to, a page at a time, each page oldest first. A reply’s thread is its first message’s. With no cursor the page is the newest replies; pass before (a reply’s uuid_v7 or id) for older ones and after for newer ones. The thread’s first message comes along as parent. Scoped to your seat like the message routes. Requires the messaging view permission.
GET
/
api
/
v1
/
messaging
/
conversations
/
{conversation_id}
/
messages
/
{message_id}
/
replies
List a thread's replies
curl --request GET \
--url https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"replies": [
{
"id": 91211,
"uuid_v7": "01a163cb-24a0-77a2-b3cf-f9f60fb25cc5",
"conversation_id": 7731,
"app": null,
"sent_via": null,
"blocks": [],
"body": "I can take it. I'll bring the new paper samples.",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:27:00Z",
"sent_at": "2026-10-22T13:27:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": {
"id": 91204,
"uuid_v7": "01a163c4-bc00-7978-8606-813749a8781a",
"conversation_id": 7731,
"blocks": [],
"body": "Who can cover the Stamford client call on Friday at 10?",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:20:00Z",
"sent_at": "2026-10-22T13:20:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "4F46E5",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Dwight",
"id": 48217,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"last_name": "Schrute",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": null,
"reply_count": 2,
"last_reply_at": "2026-10-22T13:41:00Z",
"reply_recipients": [
{
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
{
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
}
],
"thread_unread_count": 1,
"also_sent_to_channel": false,
"updated_at": "2026-10-22T13:41:00Z"
},
"reply_count": 0,
"last_reply_at": null,
"reply_recipients": [],
"thread_unread_count": 0,
"also_sent_to_channel": false
},
{
"id": 91218,
"uuid_v7": "01a163d7-f5e0-7aab-a32a-4e00a49a43d2",
"conversation_id": 7731,
"app": null,
"sent_via": null,
"blocks": [],
"body": "Thanks Jim, I'll put it on the calendar.",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:41:00Z",
"sent_at": "2026-10-22T13:41:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": {
"id": 91204,
"uuid_v7": "01a163c4-bc00-7978-8606-813749a8781a",
"conversation_id": 7731,
"blocks": [],
"body": "Who can cover the Stamford client call on Friday at 10?",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:20:00Z",
"sent_at": "2026-10-22T13:20:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "4F46E5",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Dwight",
"id": 48217,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"last_name": "Schrute",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": null,
"reply_count": 2,
"last_reply_at": "2026-10-22T13:41:00Z",
"reply_recipients": [
{
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
{
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
}
],
"thread_unread_count": 1,
"also_sent_to_channel": false,
"updated_at": "2026-10-22T13:41:00Z"
},
"reply_count": 0,
"last_reply_at": null,
"reply_recipients": [],
"thread_unread_count": 0,
"also_sent_to_channel": false
}
],
"prev_cursor": null,
"next_cursor": null,
"parent_id": 91204,
"parent": {
"id": 91204,
"uuid_v7": "01a163c4-bc00-7978-8606-813749a8781a",
"conversation_id": 7731,
"app": null,
"sent_via": null,
"blocks": [],
"body": "Who can cover the Stamford client call on Friday at 10?",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:20:00Z",
"sent_at": "2026-10-22T13:20:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "4F46E5",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Dwight",
"id": 48217,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"last_name": "Schrute",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": null,
"reply_count": 2,
"last_reply_at": "2026-10-22T13:41:00Z",
"reply_recipients": [
{
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
{
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
}
],
"thread_unread_count": 1,
"also_sent_to_channel": false
}
}{
"message": "<string>"
}{
"error": "<string>"
}Authorizations
Bearer token authentication
Path Parameters
The conversation's uuid_v7 or numeric id.
The message's uuid_v7 or numeric id.
Query Parameters
The uuid_v7 or id of the last reply already read.
The uuid_v7 or id of a reply; the page is the replies before it.
Replies per page, 50 by default and at most 100.
Response
A page of replies.
Show child attributes
Show child attributes
The oldest reply's uuid_v7 on this page when older replies exist; pass it as before.
The newest reply's uuid_v7 on this page when newer replies exist; pass it as after.
The thread's first message.
A message as it appears in a conversation's message list. Deleted messages keep their place in the list with the body replaced by a deletion notice and their attachments, mentions, and seen-by details emptied.
Show child attributes
Show child attributes
⌘I
List a thread's replies
curl --request GET \
--url https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v1/messaging/conversations/{conversation_id}/messages/{message_id}/replies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"replies": [
{
"id": 91211,
"uuid_v7": "01a163cb-24a0-77a2-b3cf-f9f60fb25cc5",
"conversation_id": 7731,
"app": null,
"sent_via": null,
"blocks": [],
"body": "I can take it. I'll bring the new paper samples.",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:27:00Z",
"sent_at": "2026-10-22T13:27:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": {
"id": 91204,
"uuid_v7": "01a163c4-bc00-7978-8606-813749a8781a",
"conversation_id": 7731,
"blocks": [],
"body": "Who can cover the Stamford client call on Friday at 10?",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:20:00Z",
"sent_at": "2026-10-22T13:20:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "4F46E5",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Dwight",
"id": 48217,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"last_name": "Schrute",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": null,
"reply_count": 2,
"last_reply_at": "2026-10-22T13:41:00Z",
"reply_recipients": [
{
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
{
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
}
],
"thread_unread_count": 1,
"also_sent_to_channel": false,
"updated_at": "2026-10-22T13:41:00Z"
},
"reply_count": 0,
"last_reply_at": null,
"reply_recipients": [],
"thread_unread_count": 0,
"also_sent_to_channel": false
},
{
"id": 91218,
"uuid_v7": "01a163d7-f5e0-7aab-a32a-4e00a49a43d2",
"conversation_id": 7731,
"app": null,
"sent_via": null,
"blocks": [],
"body": "Thanks Jim, I'll put it on the calendar.",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:41:00Z",
"sent_at": "2026-10-22T13:41:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": {
"id": 91204,
"uuid_v7": "01a163c4-bc00-7978-8606-813749a8781a",
"conversation_id": 7731,
"blocks": [],
"body": "Who can cover the Stamford client call on Friday at 10?",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:20:00Z",
"sent_at": "2026-10-22T13:20:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "4F46E5",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Dwight",
"id": 48217,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"last_name": "Schrute",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": null,
"reply_count": 2,
"last_reply_at": "2026-10-22T13:41:00Z",
"reply_recipients": [
{
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
{
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
}
],
"thread_unread_count": 1,
"also_sent_to_channel": false,
"updated_at": "2026-10-22T13:41:00Z"
},
"reply_count": 0,
"last_reply_at": null,
"reply_recipients": [],
"thread_unread_count": 0,
"also_sent_to_channel": false
}
],
"prev_cursor": null,
"next_cursor": null,
"parent_id": 91204,
"parent": {
"id": 91204,
"uuid_v7": "01a163c4-bc00-7978-8606-813749a8781a",
"conversation_id": 7731,
"app": null,
"sent_via": null,
"blocks": [],
"body": "Who can cover the Stamford client call on Friday at 10?",
"type": "DirectMessage",
"status": "sent",
"created_at": "2026-10-22T13:20:00Z",
"sent_at": "2026-10-22T13:20:00Z",
"edited_at": null,
"deleted_at": null,
"pinned": false,
"reaction": null,
"reaction_stats": null,
"metadata": {
"client_message_id": null
},
"seen_by_count": 0,
"emoji_only_count": 0,
"seen_by": [],
"sender_recipient": {
"avatar_background": "4F46E5",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Dwight",
"id": 48217,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"last_name": "Schrute",
"pro_user": false
},
"mentioned_recipients": [],
"attachments": [],
"replied_to_message": null,
"reply_count": 2,
"last_reply_at": "2026-10-22T13:41:00Z",
"reply_recipients": [
{
"avatar_background": "0EA5E9",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Jim",
"id": 48218,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/jim-halpert.jpg",
"last_name": "Halpert",
"pro_user": false
},
{
"avatar_background": "EC4899",
"blocked": false,
"blocker": false,
"discarded_at": null,
"first_name": "Pam",
"id": 48219,
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/pam-beesly.jpg",
"last_name": "Beesly",
"pro_user": false
}
],
"thread_unread_count": 1,
"also_sent_to_channel": false
}
}{
"message": "<string>"
}{
"error": "<string>"
}