Skip to main content
PATCH
/
:projectId
/
api
/
v7
/
conversations
/
:conversationId
Update Conversation
curl --request PATCH \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/conversations/:conversationId \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "avatarFileId": {},
  "postingPermission": "<string>"
}
'
Updates one or more fields on a conversation. Only group and space conversations can be updated — direct conversations return a 400. Authorization:
  • group conversations: caller must be an active admin member.
  • space conversations: caller must have admin or moderator role in the parent Space.

​
Path Parameters

​
conversationId
string
required
The ID of the conversation to update.

​
Body Parameters

All fields are optional. Only provided fields are updated.
​
name
string
New display name for the conversation. Maximum 200 characters.
​
description
string
New description. Maximum 1000 characters.
​
avatarFileId
string | null
ID of an uploaded File to use as the conversation avatar. Pass null to remove the current avatar. If a previous avatar exists, it is deleted from storage automatically.
​
postingPermission
string
Who can post messages. Only valid for space conversations. Accepted values: "members" (any active member), "admins" (only space admins and moderators).

​
Response

Returns the updated Conversation object, with avatarFile populated if set.

​
Error Responses

{ "error": "Conversation not found.", "code": "chat/not-found" }

{ "error": "Direct conversations cannot be updated.", "code": "chat/cannot-update-dm" }

{ "error": "'postingPermission' can only be set on space conversations.", "code": "chat/invalid-field" }

{ "error": "Only group admins can update this conversation.", "code": "chat/not-a-member" }

{ "error": "Only space admins and moderators can update the space conversation.", "code": "chat/not-a-member" }