List conversations other companies share with you
List the conversations other companies share with you, newest activity first, a page at a time: shared channels you have joined as a guest and, for a Fluid root admin, every company’s Fluid Support channel (the Support inbox). Open one with the conversation and message routes, using its uuid_v7; they act for your guest seat in the host company and reach nothing else of that company. Callable by a signed-in company admin or rep whose role includes the messaging view permission. Shared channels must be released to the host company.
curl --request GET \
--url https://api.fluid.app/api/v1/messaging/shared_conversations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v1/messaging/shared_conversations"
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/shared_conversations', 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/shared_conversations",
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/shared_conversations"
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/shared_conversations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v1/messaging/shared_conversations")
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{
"shared_conversations": [
{
"id": 90412,
"uuid_v7": "0192f3c4-7b1e-7c2a-9d3e-5a6b7c8d9e0f",
"name": "Fluid Support",
"purpose": "support",
"last_activity_at": "2026-10-23T05:12:00Z",
"host_company": {
"id": 3301,
"name": "Acme Wellness",
"logo_url": null
},
"seated": true,
"unread": true
}
],
"meta": {
"request_uuid": "7d3f8f0e-1c2b-4a5d-9e6f-0a1b2c3d4e5f",
"timestamp": "2026-10-23T05:15:00Z"
}
}{
"message": "<string>"
}Authorizations
Bearer token authentication
Query Parameters
relevant for only conversations that are unread for you, pinned by you, or that you replied to within 14 days.
relevant Matches the conversation name or the host company's name.
x >= 1Defaults to 50, at most 100.
1 <= x <= 100curl --request GET \
--url https://api.fluid.app/api/v1/messaging/shared_conversations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v1/messaging/shared_conversations"
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/shared_conversations', 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/shared_conversations",
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/shared_conversations"
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/shared_conversations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v1/messaging/shared_conversations")
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{
"shared_conversations": [
{
"id": 90412,
"uuid_v7": "0192f3c4-7b1e-7c2a-9d3e-5a6b7c8d9e0f",
"name": "Fluid Support",
"purpose": "support",
"last_activity_at": "2026-10-23T05:12:00Z",
"host_company": {
"id": 3301,
"name": "Acme Wellness",
"logo_url": null
},
"seated": true,
"unread": true
}
],
"meta": {
"request_uuid": "7d3f8f0e-1c2b-4a5d-9e6f-0a1b2c3d4e5f",
"timestamp": "2026-10-23T05:15:00Z"
}
}{
"message": "<string>"
}