TagMangoTagMango Docs
Community

Edit a message in one of your community chat rooms

PATCH
/api/v1/external/community/chatrooms/{roomId}/messages/{messageId}

Replace the text of a message you, the creator, previously sent — a root message or a reply, in a channel-linked or direct-message room. message is required and must be non-empty.

Text-only: this does not accept assetIds or poll — attachments and polls cannot be changed through this endpoint, matching the app, which has no UI path to change either while editing (a poll's question/options/end-date can never be edited at all, through any surface).

Author-only, always as you: only a message you yourself sent can be edited — there is no moderator or general creator-access override, even for a message posted by someone else in your own community. A messageId that doesn't exist, belongs to a different room, or wasn't sent by you all fail identically with a 404, so this never reveals whether a message you can't edit actually exists.

A message that has already been deleted cannot be edited — this fails with a 400 (errorCode: CHAT_MESSAGE_SEND_MESSAGE_ALREADY_DELETED), a deliberately stricter check than the app enforces, so a deleted message's tombstone can never be silently reanimated with new text.

On success, edited is set to true and lastEditedAt reflects this edit. Reactions and pinned state are both left completely untouched by an edit.

Fails with a 400 if the Community feature is not enabled for this creator, if message is missing or empty, or if the message has already been deleted. Fails with a 404 (errorCode: CHAT_MESSAGE_SEND_ROOM_NOT_FOUND) if roomId does not exist or is not yours, or (errorCode: CHAT_MESSAGE_SEND_MESSAGE_NOT_FOUND) if messageId does not exist, belongs to a different room, or was not sent by you.

External access policy

An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.

These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.

  • Plans: Unrestricted.

  • Tiers: Unrestricted.

AuthorizationBearer <token>

In: header

Path Parameters

roomId*string

Id of the community chat room the message belongs to

messageId*string

Id of the message to edit

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

message*string

The message text to replace the existing text with.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api-prod-new.tagmango.com/api/v1/external/community/chatrooms/61e97c146cf2b4d8c68f3a40/messages/61e97c146cf2b4d8c68f3a4a" \  -H "x-whitelabel-host: string" \  -H "Content-Type: application/json" \  -d '{    "message": "Updated message text"  }'
{
  "message": {
    "_id": "6659ca9e5f2acb7abfdcd8fd",
    "room": "6659ca9e5f2acb7abfdcd8fd",
    "message": "Hello, how are you?",
    "edited": true,
    "isDeleted": true,
    "lastEditedAt": "2021-08-01T00:00:00.000Z",
    "isThreadRoot": true,
    "threadRoot": "6659ca9e5f2acb7abfdcd8fd",
    "threadRootMetadata": {
      "firstFiveRepliers": [
        "6659ca9e5f2acb7abfdcd8fd"
      ],
      "totalReplies": 5,
      "lastRepliedAt": "2021-08-01T00:00:00.000Z",
      "lastReply": "6659ca9e5f2acb7abfdcd8fd"
    },
    "reactions": {
      "😄": 5,
      "🚀": 2,
      "❤️": 10
    },
    "createdAt": "2021-08-01T00:00:00.000Z",
    "updatedAt": "2021-08-01T00:00:00.000Z",
    "poll": "6659ca9e5f2acb7abfdcd8fd",
    "pollMetadata": {
      "creator": "6659ca9e5f2acb7abfdcd8fd",
      "question": "What is your favorite color?",
      "description": "Choose your favorite color",
      "pollOptions": [
        {
          "optionContent": "string",
          "optionNumber": 0,
          "optionId": "string"
        }
      ],
      "pollEndAt": "2021-08-01T00:00:00.000Z",
      "pollVotesPerOption": {
        "id1": 5,
        "id2": 2,
        "id3": 10
      },
      "isResultVisibleToMembers": true,
      "allowVoteChange": true,
      "pollStartAt": "2021-08-01T00:00:00.000Z"
    },
    "sender": {
      "name": "John Doe",
      "profilePicUrl": "https://linktoprofilepic.com/pic.jpg",
      "_id": "6659ca9e5f2acb7abfdcd8fd",
      "isModerator": false
    },
    "assets": [
      {
        "asset": "6659ca9e5f2acb7abfdcd8fd",
        "type": "image",
        "contentUrl": "https://example.com/image.jpg",
        "fileName": "filename.jpg",
        "fileSize": 1024,
        "fileType": "jpg"
      }
    ]
  }
}
{
  "code": 400,
  "type": "Bad Request",
  "statusMessage": "BAD_REQUEST",
  "success": false,
  "message": "Invalid request",
  "result": "Invalid request"
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "result": "Invalid token",
  "success": false
}
{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "WORKSHOP_MANGO_FORBIDDEN",
  "message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "success": false
}
{
  "code": 429,
  "type": "Too Many Requests",
  "statusMessage": "TOO_MANY_REQUESTS",
  "message": "Request limit exceeded. try after 10 seconds",
  "result": "Request limit exceeded. try after 10 seconds",
  "success": false
}