v55

latestOpenAPI 3.0.3agplraw.githubusercontent.com2026-08-01155431.3 MB
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}

Path parameters

apiVersion'v1' required
tokenstring required

Headers

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

Request body

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)

Response

Message sent successfully