Message Update

URLRequires AuthHTTP Method

/api/v1/chat.update

yes

POST

Payload

ArgumentExampleRequiredDescription

roomId

ByehQjC44FwMeiLbX

Required

The room id of where the message is.

msgId

7aDSXtjMA3KPLxLjt

Required

The message id to update.

text

Updated text

Required

Updated text for the message.

previewUrls

[
      "https://google.com",
      "https://writing-demo.dev.rocket.chat"

 ]

Optional

An array to define which URL previews should be retrieved from each message.

Example Call

curl -L -X POST 'http://localhost:3000/api/v1/chat.update' \
-H 'x-auth-token: wrhSO31BO6Zn6G5Aa_bj-kMmImONHDjXrOwGtBpQIPM' \
-H 'x-user-id: rbAXPnMktTFbNpwtJ' \
-H 'Content-Type: application/json' \
-d '{
   "roomId":"64f0f82c2c26843a68c1f7ba",
   "msgId":"vzGBzSwy6jJQDwtZe",
   "text":"Updated list of links! https://google.com https://hola.org/ https://www.usepayday.com/ https://www.getbumpa.com/ https://www.atlassian.com/software/jira https://writing-demo.dev.rocket.chat",
   "previewUrls":[
      "https://google.com",
      "https://writing-demo.dev.rocket.chat"

   ]
}'

Example Result

{
    "message": {
        "_id": "vzGBzSwy6jJQDwtZe",
        "rid": `"64f0f82c2c26843a68c1f7ba",
        "msg": "Updated list of links! https://google.com https://hola.org/ https://www.usepayday.com/ https://www.getbumpa.com/ https://www.atlassian.com/software/jira https://writing-demo.dev.rocket.chat",
        "ts": "2023-09-20T17:27:59.945Z",
        "u": {
            "_id": "rbAXPnMktTFbNpwtJ",
            "username": "roxie",
            "name": "Funke Olasupo"
        },
        "_updatedAt": "2023-09-20T22:22:45.793Z",
        "urls": [
            {
                "url": "https://google.com",
                "meta": {}
            },
            {
                "url": "https://hola.org/",
                "meta": {},
                "ignoreParse": true
            },
            {
                "url": "https://www.usepayday.com/",
                "meta": {},
                "ignoreParse": true
            },
            {
                "url": "https://www.getbumpa.com/",
                "meta": {},
                "ignoreParse": true
            },
            {
                "url": "https://www.atlassian.com/software/jira",
                "meta": {},
                "ignoreParse": true
            },
            {
                "url": "https://writing-demo.dev.rocket.chat",
                "meta": {}
            }
        ],
        "mentions": [],
        "channels": [],
        "md": [
            {
                "type": "PARAGRAPH",
                "value": [
                    {
                        "type": "PLAIN_TEXT",
                        "value": "Updated list of links! "
                    },
                    {
                        "type": "LINK",
                        "value": {
                            "src": {
                                "type": "PLAIN_TEXT",
                                "value": "https://google.com"
                            },
                            "label": [
                                {
                                    "type": "PLAIN_TEXT",
                                    "value": "https://google.com"
                                }
                            ]
                        }
                    },
                    {
                        "type": "PLAIN_TEXT",
                        "value": " "
                    },
                    {
                        "type": "LINK",
                        "value": {
                            "src": {
                                "type": "PLAIN_TEXT",
                                "value": "https://hola.org/"
                            },
                            "label": [
                                {
                                    "type": "PLAIN_TEXT",
                                    "value": "https://hola.org/"
                                }
                            ]
                        }
                    },
                    {
                        "type": "PLAIN_TEXT",
                        "value": " "
                    },
                    {
                        "type": "LINK",
                        "value": {
                            "src": {
                                "type": "PLAIN_TEXT",
                                "value": "https://www.usepayday.com/"
                            },
                            "label": [
                                {
                                    "type": "PLAIN_TEXT",
                                    "value": "https://www.usepayday.com/"
                                }
                            ]
                        }
                    },
                    {
                        "type": "PLAIN_TEXT",
                        "value": " "
                    },
                    {
                        "type": "LINK",
                        "value": {
                            "src": {
                                "type": "PLAIN_TEXT",
                                "value": "https://www.getbumpa.com/"
                            },
                            "label": [
                                {
                                    "type": "PLAIN_TEXT",
                                    "value": "https://www.getbumpa.com/"
                                }
                            ]
                        }
                    },
                    {
                        "type": "PLAIN_TEXT",
                        "value": " "
                    },
                    {
                        "type": "LINK",
                        "value": {
                            "src": {
                                "type": "PLAIN_TEXT",
                                "value": "https://www.atlassian.com/software/jira"
                            },
                            "label": [
                                {
                                    "type": "PLAIN_TEXT",
                                    "value": "https://www.atlassian.com/software/jira"
                                }
                            ]
                        }
                    },
                    {
                        "type": "PLAIN_TEXT",
                        "value": " "
                    },
                    {
                        "type": "LINK",
                        "value": {
                            "src": {
                                "type": "PLAIN_TEXT",
                                "value": "https://writing-demo.dev.rocket.chat"
                            },
                            "label": [
                                {
                                    "type": "PLAIN_TEXT",
                                    "value": "https://writing-demo.dev.rocket.chat"
                                }
                            ]
                        }
                    }
                ]
            }
        ],
        "editedAt": "2023-09-20T22:22:45.737Z",
        "editedBy": {
            "_id": "rbAXPnMktTFbNpwtJ",
            "username": "roxie"
        }
    },
    "success": true
}`

Change Log

VersionDescription

0.49.0

Added

6.4.0

Add previewUrls param

Last updated

Rocket.Chat versions receive support for six months after release.