chat

Sends a new chat message to the given room

The author and timestamp are automatically set to the current user/guest and time.

post/ocs/v2.php/apps/spreed/api/{apiVersion}/chat/{token}

Request

apiVersion'v1' required

tokenstring required

x-nextcloud-federationstring

Set to 1 when the request is performed by another Nextcloud Server to indicate a federation request

OCS-APIRequestboolean required

Required to be true for the API request to pass

messagestring required

the message to send

actorDisplayNamestring

for guests

referenceIdstring

for the message to be able to later identify it again

replyTointeger

Parent id which this message is a reply to

replyToTokenstring

Parent token to which reply is initiated

silentboolean

If sent silent the chat message will not create any notifications

threadTitlestring

Only supported when not replying, when given will create a thread (requires threads capability)

threadIdinteger

Thread id which this message is a reply to without quoting a specific message (ignored when $replyTo is given, also requires threads capability)

Message sent successfully

Oct 9, 2026bedff1ae4e89 Revision changes
- info
  added the non-success response with the status
Mar 31, 2026dc2b6567a07b Revision changes
- info
  added the new optional request property
- info
  added the non-success response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status