TagMangoTagMango Docs
Community

Reply to a message in one of your community chat rooms

POST
/api/v1/external/community/chatrooms/{roomId}/messages/{messageId}/replies

Reply to a specific message (messageId) in one of your chat rooms, as you, the creator. Behaves exactly like sending a root message — same message/assetIds/poll rules, same side effects — except the reply is attached to messageId's thread instead of starting a new one, and it does not update the room's own preview (lastMessage/lastMessageNumber) the way a root message does.

messageId must be a root message in this room — a message that is itself already a reply cannot be replied to (nested threading isn't supported); that fails with a 400 (errorCode: CHAT_MESSAGE_SEND_THREAD_ROOT_IS_ITSELF_A_REPLY). A messageId that doesn't exist, or belongs to a different room, fails with a 404 (errorCode: CHAT_MESSAGE_SEND_THREAD_ROOT_NOT_FOUND).

On success, the replied-to message's own threadRootMetadata updates: totalReplies increments, lastReply/lastRepliedAt point at this new reply, and you are added to firstFiveRepliers if it has fewer than 5 entries already. Fetch that message again (via the message-listing endpoint) to see the updated counts.

Fails with a 400 if the Community feature is not enabled for this creator, if a poll is given for a direct-message room (errorCode: CHAT_MESSAGE_SEND_POLL_NOT_ALLOWED_IN_DM), if the room's other participant has stopped receiving messages from you (errorCode: CHAT_MESSAGE_SEND_RECEIVER_STOPPED_RECEIVING), if poll.pollEndAt is not strictly in the future (errorCode: CHAT_MESSAGE_SEND_POLL_END_DATE_NOT_IN_FUTURE), or if any attached asset exceeds 50MB (errorCode: TM_CLOUD_UPLOAD_FILE_SIZE_EXCEEDED). Fails with a 404 (errorCode: CHAT_MESSAGE_SEND_ROOM_NOT_FOUND) if roomId does not exist or is not yours to send into.

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

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.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/community/chatrooms/{roomId}/messages/{messageId}/replies" \  -H "x-whitelabel-host: string" \  -H "Content-Type: application/json" \  -d '{    "message": "Hello there!"  }'
{
  "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
}