Discussions
List the company's shared discussions
Requires a user session with multiplayer_discussions.view. Returns the company’s discussions, newest first, with stable cursor pagination, and the work they led to for callers who may read work. With include_messages, each discussion also brings its first page of messages; a discussion whose message_count exceeds the messages listed has more to read from its messages endpoint. Source-bound conversations are listed only while the original source exists and the caller can read it. source_kind and source_id together narrow the page to one original task or preview thread. Conversations that used preview context also require current theme read access, even after a thread is unlinked. Retained product/order source permissions are checked for every reader before pagination, including opening messages and titles.
GET
/
api
/
v202604
/
multiplayer
/
discussions
List the company's shared discussions
curl --request GET \
--url https://api.fluid.app/api/v202604/multiplayer/discussions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/discussions"
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/v202604/multiplayer/discussions', 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/v202604/multiplayer/discussions",
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/v202604/multiplayer/discussions"
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/v202604/multiplayer/discussions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/discussions")
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{
"discussions": [
{
"id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"answer_claim": null,
"channel": {
"kind": "sms",
"number_last4": "0100"
},
"client_id": "acme-themes",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:31Z",
"creator": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"message_count": 2,
"shared_at": null,
"source": null,
"title": "Fluid themes",
"updated_at": "2026-11-12T17:53:07Z"
}
],
"task_links": [],
"messages": [
{
"id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"admin_page": null,
"author": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"body": "What can you tell me about Fluid themes?",
"client_id": "acme-themes-question",
"created_at": "2026-11-12T17:50:31Z",
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"page_results": [],
"resource_results": [],
"role": "human",
"round_limit_reached": false,
"sequence": 1
},
{
"id": "01a1d0e4-5655-7344-a202-99ac5b032ccf",
"admin_page": null,
"author": null,
"body": "Saved facts",
"client_id": null,
"created_at": "2026-11-12T17:53:07Z",
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"format": "text",
"page_results": [],
"resource_results": [
{
"receipt_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147:product:0",
"request_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147",
"tool_call_id": "product",
"recorded_at": "2026-11-12T17:53:07.440780Z",
"source_kind": "product",
"source_id": "836331430",
"state": "available",
"observation": "detail",
"admin_path": "/products/836331430",
"api_path": "/api/company/v1/products/836331430",
"required_permissions": [
"storefront.view"
],
"summary": {
"title": "Acme Product",
"sku": null,
"status": null,
"active": null,
"price": null,
"currency_code": null,
"in_stock": null,
"image_url": null,
"updated_at": null
}
},
{
"receipt_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147:order:0",
"request_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147",
"tool_call_id": "order",
"recorded_at": "2026-11-12T17:53:07.605822Z",
"source_kind": "order",
"source_id": "619885273",
"state": "available",
"observation": "detail",
"admin_path": "/orders/619885273",
"api_path": "/api/v2/orders/619885273",
"required_permissions": [
"orders.view"
],
"summary": {
"order_number": "1001",
"status": null,
"financial_status": null,
"fulfillment_status": null,
"created_at": null,
"customer_name": null,
"amount": null,
"currency_code": null,
"items_count": null,
"items": []
}
}
],
"role": "assistant",
"round_limit_reached": false,
"sequence": 2
}
],
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:53:07Z",
"pagination": {
"cursor": null,
"limit": 25,
"prev_cursor": null,
"next_cursor": null
}
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Opaque cursor returned by the previous page.
Maximum string length:
4096Maximum records to return, defaulting to 25.
Required range:
1 <= x <= 100When true, the response includes messages, the first 25 messages of each listed discussion within 1 MiB of message bodies. Defaults to false.
Original work kind; supply with source_id.
Available options:
task, preview_thread Original task UUID or preview root row ID; supply with source_kind.
Maximum string length:
64Response
A page of the company's discussions.
Show child attributes
Show child attributes
Work the discussions on this page led to, oldest first, excluding deleted work. Empty unless the caller also holds multiplayer_tasks.view or application_themes.view, so listing discussions alone reveals no task ids, titles or counts.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Present only with include_messages. Up to the first 25 messages of each discussion on this page, grouped by discussion in the order discussions lists them, each in the order it accepted them. Listing stops before the bodies exceed 1 MiB, so a later discussion may bring fewer messages than its message_count, or none.
Show child attributes
Show child attributes
⌘I
List the company's shared discussions
curl --request GET \
--url https://api.fluid.app/api/v202604/multiplayer/discussions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/discussions"
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/v202604/multiplayer/discussions', 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/v202604/multiplayer/discussions",
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/v202604/multiplayer/discussions"
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/v202604/multiplayer/discussions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/discussions")
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{
"discussions": [
{
"id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"answer_claim": null,
"channel": {
"kind": "sms",
"number_last4": "0100"
},
"client_id": "acme-themes",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:31Z",
"creator": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"message_count": 2,
"shared_at": null,
"source": null,
"title": "Fluid themes",
"updated_at": "2026-11-12T17:53:07Z"
}
],
"task_links": [],
"messages": [
{
"id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"admin_page": null,
"author": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"body": "What can you tell me about Fluid themes?",
"client_id": "acme-themes-question",
"created_at": "2026-11-12T17:50:31Z",
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"page_results": [],
"resource_results": [],
"role": "human",
"round_limit_reached": false,
"sequence": 1
},
{
"id": "01a1d0e4-5655-7344-a202-99ac5b032ccf",
"admin_page": null,
"author": null,
"body": "Saved facts",
"client_id": null,
"created_at": "2026-11-12T17:53:07Z",
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"format": "text",
"page_results": [],
"resource_results": [
{
"receipt_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147:product:0",
"request_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147",
"tool_call_id": "product",
"recorded_at": "2026-11-12T17:53:07.440780Z",
"source_kind": "product",
"source_id": "836331430",
"state": "available",
"observation": "detail",
"admin_path": "/products/836331430",
"api_path": "/api/company/v1/products/836331430",
"required_permissions": [
"storefront.view"
],
"summary": {
"title": "Acme Product",
"sku": null,
"status": null,
"active": null,
"price": null,
"currency_code": null,
"in_stock": null,
"image_url": null,
"updated_at": null
}
},
{
"receipt_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147:order:0",
"request_id": "01a1d0e4-54d2-7991-93cd-9ea88779f147",
"tool_call_id": "order",
"recorded_at": "2026-11-12T17:53:07.605822Z",
"source_kind": "order",
"source_id": "619885273",
"state": "available",
"observation": "detail",
"admin_path": "/orders/619885273",
"api_path": "/api/v2/orders/619885273",
"required_permissions": [
"orders.view"
],
"summary": {
"order_number": "1001",
"status": null,
"financial_status": null,
"fulfillment_status": null,
"created_at": null,
"customer_name": null,
"amount": null,
"currency_code": null,
"items_count": null,
"items": []
}
}
],
"role": "assistant",
"round_limit_reached": false,
"sequence": 2
}
],
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:53:07Z",
"pagination": {
"cursor": null,
"limit": 25,
"prev_cursor": null,
"next_cursor": null
}
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}