Discussions
Start a shared company discussion
Requires an authenticated person who is a company admin with multiplayer_discussions.create. Company and creator come from the authenticated session. Saves the discussion and its first message together. Retrying the same client_id with the same title and message returns the saved discussion with 200; a retry that changes any of them, including the optional original source or the first message’s admin page, returns 409. Starting from work also requires permission to read that live company source.
POST
/
api
/
v202604
/
multiplayer
/
discussions
Start a shared company discussion
curl --request POST \
--url https://api.fluid.app/api/v202604/multiplayer/discussions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"discussion": {
"client_id": "task-source",
"title": "Existing task",
"source": {
"kind": "task",
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a"
},
"message": {
"client_id": "m-1",
"body": "Can we discuss this work?"
}
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/discussions"
payload = { "discussion": {
"client_id": "task-source",
"title": "Existing task",
"source": {
"kind": "task",
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a"
},
"message": {
"client_id": "m-1",
"body": "Can we discuss this work?"
}
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
discussion: {
client_id: 'task-source',
title: 'Existing task',
source: {kind: 'task', id: '9271f7b9-237c-5dbe-ab78-f866652d747a'},
message: {client_id: 'm-1', body: JSON.stringify('Can we discuss this work?')}
}
})
};
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 => "POST",
CURLOPT_POSTFIELDS => json_encode([
'discussion' => [
'client_id' => 'task-source',
'title' => 'Existing task',
'source' => [
'kind' => 'task',
'id' => '9271f7b9-237c-5dbe-ab78-f866652d747a'
],
'message' => [
'client_id' => 'm-1',
'body' => 'Can we discuss this work?'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/multiplayer/discussions"
payload := strings.NewReader("{\n \"discussion\": {\n \"client_id\": \"task-source\",\n \"title\": \"Existing task\",\n \"source\": {\n \"kind\": \"task\",\n \"id\": \"9271f7b9-237c-5dbe-ab78-f866652d747a\"\n },\n \"message\": {\n \"client_id\": \"m-1\",\n \"body\": \"Can we discuss this work?\"\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202604/multiplayer/discussions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"discussion\": {\n \"client_id\": \"task-source\",\n \"title\": \"Existing task\",\n \"source\": {\n \"kind\": \"task\",\n \"id\": \"9271f7b9-237c-5dbe-ab78-f866652d747a\"\n },\n \"message\": {\n \"client_id\": \"m-1\",\n \"body\": \"Can we discuss this work?\"\n }\n }\n}")
.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::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"discussion\": {\n \"client_id\": \"task-source\",\n \"title\": \"Existing task\",\n \"source\": {\n \"kind\": \"task\",\n \"id\": \"9271f7b9-237c-5dbe-ab78-f866652d747a\"\n },\n \"message\": {\n \"client_id\": \"m-1\",\n \"body\": \"Can we discuss this work?\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"discussion": {
"id": "01a1d0e2-1a30-733c-a448-90aada80f7f4",
"answer_claim": null,
"channel": null,
"client_id": "preview-source",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:41Z",
"creator": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"message_count": 1,
"shared_at": null,
"source": {
"kind": "preview_thread",
"id": "923023514"
},
"title": "Collection copy",
"updated_at": "2026-11-12T17:50:41Z"
},
"message": {
"id": "01a1d0e2-1a31-7532-acce-0e473c43a863",
"admin_page": null,
"author": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"body": "What should we change here?",
"client_id": "m-1",
"created_at": "2026-11-12T17:50:41Z",
"discussion_id": "01a1d0e2-1a30-733c-a448-90aada80f7f4",
"page_results": [],
"resource_results": [],
"role": "human",
"round_limit_reached": false,
"sequence": 1
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:50:41Z"
}
}{
"discussion": {
"id": "01a1d0e2-19b5-721e-b673-7a4aae576e47",
"answer_claim": null,
"channel": null,
"client_id": "task-source",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:41Z",
"creator": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"message_count": 1,
"shared_at": null,
"source": {
"kind": "task",
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a"
},
"title": "Existing task",
"updated_at": "2026-11-12T17:50:41Z"
},
"message": {
"id": "01a1d0e2-19b6-73e3-b5e2-576dcb61695d",
"admin_page": null,
"author": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"body": "Can we discuss this work?",
"client_id": "m-1",
"created_at": "2026-11-12T17:50:41Z",
"discussion_id": "01a1d0e2-19b5-721e-b673-7a4aae576e47",
"page_results": [],
"resource_results": [],
"role": "human",
"round_limit_reached": false,
"sequence": 1
},
"status": 201,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:50:41Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {
"type": "conflict",
"discussion": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_id": "<string>",
"company_id": 123,
"title": "<string>",
"source": {
"kind": "task",
"id": "<string>"
},
"creator": {
"id": "<string>",
"name": "<string>",
"kind": "user"
},
"message_count": 2,
"channel": {
"kind": "sms",
"number_last4": "<string>"
},
"shared_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"answer_claim": {
"producer": "<string>",
"through_sequence": 2,
"answered": true,
"expires_at": "2023-11-07T05:31:56Z"
}
}
}
},
"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.
Body
application/json
Show child attributes
Show child attributes
Response
An identical retry; the saved discussion and first message are returned and nothing new is written.
A company chat. It is private to its creator until they share it with the work it led to. It holds no task state.
Show child attributes
Show child attributes
One message, numbered in the order the discussion accepted it. A person's message is immutable.
Show child attributes
Show child attributes
Available options:
200, 201 Show child attributes
Show child attributes
⌘I
Start a shared company discussion
curl --request POST \
--url https://api.fluid.app/api/v202604/multiplayer/discussions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"discussion": {
"client_id": "task-source",
"title": "Existing task",
"source": {
"kind": "task",
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a"
},
"message": {
"client_id": "m-1",
"body": "Can we discuss this work?"
}
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/discussions"
payload = { "discussion": {
"client_id": "task-source",
"title": "Existing task",
"source": {
"kind": "task",
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a"
},
"message": {
"client_id": "m-1",
"body": "Can we discuss this work?"
}
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
discussion: {
client_id: 'task-source',
title: 'Existing task',
source: {kind: 'task', id: '9271f7b9-237c-5dbe-ab78-f866652d747a'},
message: {client_id: 'm-1', body: JSON.stringify('Can we discuss this work?')}
}
})
};
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 => "POST",
CURLOPT_POSTFIELDS => json_encode([
'discussion' => [
'client_id' => 'task-source',
'title' => 'Existing task',
'source' => [
'kind' => 'task',
'id' => '9271f7b9-237c-5dbe-ab78-f866652d747a'
],
'message' => [
'client_id' => 'm-1',
'body' => 'Can we discuss this work?'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/multiplayer/discussions"
payload := strings.NewReader("{\n \"discussion\": {\n \"client_id\": \"task-source\",\n \"title\": \"Existing task\",\n \"source\": {\n \"kind\": \"task\",\n \"id\": \"9271f7b9-237c-5dbe-ab78-f866652d747a\"\n },\n \"message\": {\n \"client_id\": \"m-1\",\n \"body\": \"Can we discuss this work?\"\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202604/multiplayer/discussions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"discussion\": {\n \"client_id\": \"task-source\",\n \"title\": \"Existing task\",\n \"source\": {\n \"kind\": \"task\",\n \"id\": \"9271f7b9-237c-5dbe-ab78-f866652d747a\"\n },\n \"message\": {\n \"client_id\": \"m-1\",\n \"body\": \"Can we discuss this work?\"\n }\n }\n}")
.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::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"discussion\": {\n \"client_id\": \"task-source\",\n \"title\": \"Existing task\",\n \"source\": {\n \"kind\": \"task\",\n \"id\": \"9271f7b9-237c-5dbe-ab78-f866652d747a\"\n },\n \"message\": {\n \"client_id\": \"m-1\",\n \"body\": \"Can we discuss this work?\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"discussion": {
"id": "01a1d0e2-1a30-733c-a448-90aada80f7f4",
"answer_claim": null,
"channel": null,
"client_id": "preview-source",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:41Z",
"creator": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"message_count": 1,
"shared_at": null,
"source": {
"kind": "preview_thread",
"id": "923023514"
},
"title": "Collection copy",
"updated_at": "2026-11-12T17:50:41Z"
},
"message": {
"id": "01a1d0e2-1a31-7532-acce-0e473c43a863",
"admin_page": null,
"author": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"body": "What should we change here?",
"client_id": "m-1",
"created_at": "2026-11-12T17:50:41Z",
"discussion_id": "01a1d0e2-1a30-733c-a448-90aada80f7f4",
"page_results": [],
"resource_results": [],
"role": "human",
"round_limit_reached": false,
"sequence": 1
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:50:41Z"
}
}{
"discussion": {
"id": "01a1d0e2-19b5-721e-b673-7a4aae576e47",
"answer_claim": null,
"channel": null,
"client_id": "task-source",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:41Z",
"creator": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"message_count": 1,
"shared_at": null,
"source": {
"kind": "task",
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a"
},
"title": "Existing task",
"updated_at": "2026-11-12T17:50:41Z"
},
"message": {
"id": "01a1d0e2-19b6-73e3-b5e2-576dcb61695d",
"admin_page": null,
"author": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"body": "Can we discuss this work?",
"client_id": "m-1",
"created_at": "2026-11-12T17:50:41Z",
"discussion_id": "01a1d0e2-19b5-721e-b673-7a4aae576e47",
"page_results": [],
"resource_results": [],
"role": "human",
"round_limit_reached": false,
"sequence": 1
},
"status": 201,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:50:41Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {
"type": "conflict",
"discussion": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_id": "<string>",
"company_id": 123,
"title": "<string>",
"source": {
"kind": "task",
"id": "<string>"
},
"creator": {
"id": "<string>",
"name": "<string>",
"kind": "user"
},
"message_count": 2,
"channel": {
"kind": "sms",
"number_last4": "<string>"
},
"shared_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"answer_claim": {
"producer": "<string>",
"through_sequence": 2,
"answered": true,
"expires_at": "2023-11-07T05:31:56Z"
}
}
}
},
"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"
}
}