Channels

Update a conversation

Rename a conversation, change its description, or add participants. Callable by a signed-in company admin or rep whose role includes the messaging update permission, on an open or initiated conversation you belong to.

additional_recipient_params adds participants to a group conversation only, identified by receivable_id and receivable_type; participants who previously left are re-added. auto_add_recipients is applied only for company admins. The announcement channel can be renamed only by a root admin. Participants are notified of a rename and of newly added members.

PUT

api

messaging

conversations

{id}

Update a conversation

curl --request PUT \
  --url https://api.fluid.app/api/v1/messaging/conversations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "name": "Scranton Sales Team",
    "description": "Daily numbers and client follow-ups for the Scranton branch",
    "additional_recipient_params": [
      {
        "receivable_id": 7864,
        "receivable_type": "UserCompany"
      }
    ]
  }
}
'

import requests

url = "https://api.fluid.app/api/v1/messaging/conversations/{id}"

payload = { "conversation": {
        "name": "Scranton Sales Team",
        "description": "Daily numbers and client follow-ups for the Scranton branch",
        "additional_recipient_params": [
            {
                "receivable_id": 7864,
                "receivable_type": "UserCompany"
            }
        ]
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversation: {
      name: 'Scranton Sales Team',
      description: 'Daily numbers and client follow-ups for the Scranton branch',
      additional_recipient_params: [{receivable_id: 7864, receivable_type: 'UserCompany'}]
    }
  })
};

fetch('https://api.fluid.app/api/v1/messaging/conversations/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'conversation' => [
        'name' => 'Scranton Sales Team',
        'description' => 'Daily numbers and client follow-ups for the Scranton branch',
        'additional_recipient_params' => [
                [
                                'receivable_id' => 7864,
                                'receivable_type' => 'UserCompany'
                ]
        ]
    ]
  ]),
  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/v1/messaging/conversations/{id}"

	payload := strings.NewReader("{\n  \"conversation\": {\n    \"name\": \"Scranton Sales Team\",\n    \"description\": \"Daily numbers and client follow-ups for the Scranton branch\",\n    \"additional_recipient_params\": [\n      {\n        \"receivable_id\": 7864,\n        \"receivable_type\": \"UserCompany\"\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/v1/messaging/conversations/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversation\": {\n    \"name\": \"Scranton Sales Team\",\n    \"description\": \"Daily numbers and client follow-ups for the Scranton branch\",\n    \"additional_recipient_params\": [\n      {\n        \"receivable_id\": 7864,\n        \"receivable_type\": \"UserCompany\"\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v1/messaging/conversations/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation\": {\n    \"name\": \"Scranton Sales Team\",\n    \"description\": \"Daily numbers and client follow-ups for the Scranton branch\",\n    \"additional_recipient_params\": [\n      {\n        \"receivable_id\": 7864,\n        \"receivable_type\": \"UserCompany\"\n      }\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": 90412,
  "type": "GroupConversation",
  "kind": "group",
  "name": "Scranton Sales Team",
  "description": "Daily numbers and client follow-ups for the Scranton branch",
  "status": "open",
  "conversation_type": "internal",
  "broadcasting": null,
  "auto_add_recipients": null,
  "announcing": false,
  "avatar_background_color": null,
  "avatar_emoji": null,
  "avatar_url": null,
  "image_url": null,
  "created_at": "2026-09-14T15:42:07Z",
  "pinned_messages_count": 1,
  "total_recipients": 5,
  "unread": true,
  "pinned": false,
  "muted": false,
  "unread_messages_count": 3,
  "scheduled_messages_count": 0,
  "email_enabled?": false,
  "sms_enabled?": false,
  "messaging_enabled?": true,
  "draft_message": null,
  "recipients": [
    {
      "id": 48102,
      "receivable_id": 7731,
      "receivable_type": "UserCompany",
      "first_name": "Michael",
      "last_name": "Scott",
      "status": "active",
      "last_online": "2026-09-30T15:40:12Z",
      "avatar_background": "#4F46E5",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": true,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48211,
      "receivable_id": 7802,
      "receivable_type": "UserCompany",
      "first_name": "Dwight",
      "last_name": "Schrute",
      "status": "active",
      "last_online": "2026-09-30T14:58:03Z",
      "avatar_background": "#0EA5E9",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": true,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48307,
      "receivable_id": 7859,
      "receivable_type": "UserCompany",
      "first_name": "Jim",
      "last_name": "Halpert",
      "status": "active",
      "last_online": "2026-09-30T09:17:31Z",
      "avatar_background": "#F59E0B",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": false,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48362,
      "receivable_id": 7871,
      "receivable_type": "UserCompany",
      "first_name": "Stanley",
      "last_name": "Hudson",
      "status": "active",
      "last_online": "2026-09-28T17:00:00Z",
      "avatar_background": "#10B981",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": false,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48355,
      "receivable_id": 7864,
      "receivable_type": "UserCompany",
      "first_name": "Pam",
      "last_name": "Beesly",
      "status": "active",
      "last_online": "2026-09-29T21:03:55Z",
      "avatar_background": "#EC4899",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": false,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    }
  ],
  "creator": {
    "id": 48102,
    "first_name": "Michael",
    "last_name": "Scott",
    "avatar_background": "#4F46E5",
    "image_url": null,
    "pro_user": true,
    "blocked": false,
    "blocker": false,
    "discarded_at": null
  }
}

{
  "message": "<string>"
}

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Path Parameters

string

required

The conversation's uuid_v7, or its numeric id.

Body

application/json

conversation

object

required

Show child attributes

Response

The updated conversation.

A conversation as seen by the acting recipient. Per-recipient fields such as unread, pinned, and muted describe that recipient's view of the conversation. recipients lists at most six active participants; total_recipients is the full count.

integer | null

required

type

string

required

The conversation type, for example GroupConversation.

kind

string | null

required

The short conversation kind (direct, group, channel, or downline), or null for SMS, email, and bot conversations.

name

string | null

required

description

string | null

required

status

string | null

required

One of initiated, open, archived, or closed. A new conversation stays initiated until its first message.

conversation_type

string | null

required

internal for conversations between company members, external for conversations with contacts.

broadcasting

boolean | null

required

auto_add_recipients

boolean | null

required

announcing

boolean | null

required

avatar_background_color

string | null

required

avatar_emoji

string | null

required

avatar_url

string | null

required

image_url

string | null

required

created_at

string<date-time> | null

required

pinned_messages_count

integer | null

required

total_recipients

integer | null

required

unread

boolean | null

required

pinned

boolean | null

required

muted

boolean | null

required

unread_messages_count

integer | null

required

scheduled_messages_count

integer | null

required

email_enabled?

boolean | null

required

sms_enabled?

boolean | null

required

messaging_enabled?

boolean | null

required

Whether the acting recipient can post in the conversation.

draft_message

object | null

required

The acting recipient's unsent draft in this conversation, or null.

recipients

object[]

required

Show child attributes

creator

object | null

required

The recipient who created a conversation.

Show child attributes

audience

enum<string>

Who a channel is for; admins seats only the company's admins, now and as admins come and go.

Available options:

members,

admins

ticket

object | null

For a Cowork ticket's or board card's channel, what it discusses; null otherwise. A board card has only id, title and status; a Cowork ticket also has the rest, which names people by name and avatar only.

Show child attributes

host_company_name

string | null

For a guest from another company, the name of the company hosting the conversation; null for the host's own people.

purpose

string | null

What Fluid made the conversation for: support for the company's Fluid Support channel, ticket for a Cowork ticket's channel, or null for one people created.

uuid_v7

string<uuid>

The stable UUIDv7 identifier. Messaging routes accept it wherever they accept the numeric id.

unread_mentions_count

integer | null

Unread messages that need you — every unread message in a direct or group conversation, only mentions in a channel. Shown as the numbered badge.

can_delete_any_message

boolean

Whether you may delete other people's messages here. True for the company's own admins in a channel; false in direct and group conversations and for guests from a company the channel is shared with.

last_activity_at

string<date-time> | null

When anything last happened in the conversation.

last_opened_at

string<date-time> | null

When you last opened it (your seat's last read time); null without a seat.

last_replied_at

string<date-time> | null

When you last sent a message in it; null if you never have.

Update a conversation

curl --request PUT \
  --url https://api.fluid.app/api/v1/messaging/conversations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "name": "Scranton Sales Team",
    "description": "Daily numbers and client follow-ups for the Scranton branch",
    "additional_recipient_params": [
      {
        "receivable_id": 7864,
        "receivable_type": "UserCompany"
      }
    ]
  }
}
'

import requests

url = "https://api.fluid.app/api/v1/messaging/conversations/{id}"

payload = { "conversation": {
        "name": "Scranton Sales Team",
        "description": "Daily numbers and client follow-ups for the Scranton branch",
        "additional_recipient_params": [
            {
                "receivable_id": 7864,
                "receivable_type": "UserCompany"
            }
        ]
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversation: {
      name: 'Scranton Sales Team',
      description: 'Daily numbers and client follow-ups for the Scranton branch',
      additional_recipient_params: [{receivable_id: 7864, receivable_type: 'UserCompany'}]
    }
  })
};

fetch('https://api.fluid.app/api/v1/messaging/conversations/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'conversation' => [
        'name' => 'Scranton Sales Team',
        'description' => 'Daily numbers and client follow-ups for the Scranton branch',
        'additional_recipient_params' => [
                [
                                'receivable_id' => 7864,
                                'receivable_type' => 'UserCompany'
                ]
        ]
    ]
  ]),
  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/v1/messaging/conversations/{id}"

	payload := strings.NewReader("{\n  \"conversation\": {\n    \"name\": \"Scranton Sales Team\",\n    \"description\": \"Daily numbers and client follow-ups for the Scranton branch\",\n    \"additional_recipient_params\": [\n      {\n        \"receivable_id\": 7864,\n        \"receivable_type\": \"UserCompany\"\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/v1/messaging/conversations/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversation\": {\n    \"name\": \"Scranton Sales Team\",\n    \"description\": \"Daily numbers and client follow-ups for the Scranton branch\",\n    \"additional_recipient_params\": [\n      {\n        \"receivable_id\": 7864,\n        \"receivable_type\": \"UserCompany\"\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v1/messaging/conversations/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation\": {\n    \"name\": \"Scranton Sales Team\",\n    \"description\": \"Daily numbers and client follow-ups for the Scranton branch\",\n    \"additional_recipient_params\": [\n      {\n        \"receivable_id\": 7864,\n        \"receivable_type\": \"UserCompany\"\n      }\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": 90412,
  "type": "GroupConversation",
  "kind": "group",
  "name": "Scranton Sales Team",
  "description": "Daily numbers and client follow-ups for the Scranton branch",
  "status": "open",
  "conversation_type": "internal",
  "broadcasting": null,
  "auto_add_recipients": null,
  "announcing": false,
  "avatar_background_color": null,
  "avatar_emoji": null,
  "avatar_url": null,
  "image_url": null,
  "created_at": "2026-09-14T15:42:07Z",
  "pinned_messages_count": 1,
  "total_recipients": 5,
  "unread": true,
  "pinned": false,
  "muted": false,
  "unread_messages_count": 3,
  "scheduled_messages_count": 0,
  "email_enabled?": false,
  "sms_enabled?": false,
  "messaging_enabled?": true,
  "draft_message": null,
  "recipients": [
    {
      "id": 48102,
      "receivable_id": 7731,
      "receivable_type": "UserCompany",
      "first_name": "Michael",
      "last_name": "Scott",
      "status": "active",
      "last_online": "2026-09-30T15:40:12Z",
      "avatar_background": "#4F46E5",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": true,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48211,
      "receivable_id": 7802,
      "receivable_type": "UserCompany",
      "first_name": "Dwight",
      "last_name": "Schrute",
      "status": "active",
      "last_online": "2026-09-30T14:58:03Z",
      "avatar_background": "#0EA5E9",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": true,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48307,
      "receivable_id": 7859,
      "receivable_type": "UserCompany",
      "first_name": "Jim",
      "last_name": "Halpert",
      "status": "active",
      "last_online": "2026-09-30T09:17:31Z",
      "avatar_background": "#F59E0B",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": false,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48362,
      "receivable_id": 7871,
      "receivable_type": "UserCompany",
      "first_name": "Stanley",
      "last_name": "Hudson",
      "status": "active",
      "last_online": "2026-09-28T17:00:00Z",
      "avatar_background": "#10B981",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": false,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    },
    {
      "id": 48355,
      "receivable_id": 7864,
      "receivable_type": "UserCompany",
      "first_name": "Pam",
      "last_name": "Beesly",
      "status": "active",
      "last_online": "2026-09-29T21:03:55Z",
      "avatar_background": "#EC4899",
      "avatar_url": null,
      "image_url": null,
      "country_name": "United States",
      "pro_user": false,
      "blocked": false,
      "left_conversation_at": null,
      "discarded_at": null
    }
  ],
  "creator": {
    "id": 48102,
    "first_name": "Michael",
    "last_name": "Scott",
    "avatar_background": "#4F46E5",
    "image_url": null,
    "pro_user": true,
    "blocked": false,
    "blocker": false,
    "discarded_at": null
  }
}

{
  "message": "<string>"
}

{
  "error": "<string>"
}

Overview

Storefront

Commerce

Checkout

Member API

Member Sites APIs

Messaging

Cowork

People

Payments

DAM

Website

Portal

Mobile app

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Unsorted endpoints

Portal & Widgets

Update a conversation

Authorizations

Path Parameters

Body

Response