TagMangoTagMango Docs
Community

List replies to a message in one of your community chat rooms

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

List replies in a specific message's thread — messageId is the thread-root, the same message you'd pass when replying to it. This is cursor-based, not page-based: mode says which slice of the thread's history to fetch relative to cursorMessageId, and replies are always returned oldest first, regardless of mode.

messageId must be a root message in this room. A messageId that doesn't exist at all, or belongs to a different room, fails with a 404 (plain "Thread root message not found"). A messageId that exists but is itself already a reply fails with a 400 ("messageId is itself a reply, not a thread root — it has no replies of its own") — a reply has no thread of its own. This is deliberately stricter than the internal app, which silently returns an empty list for both cases — a wrong id is more useful to you as an explicit error than a list that looks like "no replies yet".

This endpoint only ever returns the replies themselves — never the thread-root message, and never aggregate stats like a total reply count. Fetch the thread-root through the room message-listing endpoint to see its threadRootMetadata (totalReplies, lastReply, etc.), which updates as replies come in.

Every reply is personalized to you: myReaction carries your own active reaction (absent if you haven't reacted to that reply). isPinned is always false here — a reply can never be pinned, only its thread-root message can.

Fails with a 400 if the Community feature is not enabled for this creator, or a 404 if roomId doesn't exist or isn't yours to see.

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

Query Parameters

mode*string

Which slice of the thread to fetch, relative to cursorMessageId — one of: before-message, after-message, around-last-seen, around-message, from-start, latest. from-start: the oldest limit replies in the thread, oldest first. No cursorMessageId needed. latest: the newest limit replies in the thread, returned oldest first. No cursorMessageId needed. before-message: the limit replies immediately before cursorMessageId (which is excluded), oldest first — for scrolling further into the past. after-message: the limit replies immediately after cursorMessageId (which is excluded), oldest first — for scrolling forward again. around-message: up to limit replies centered on cursorMessageId (which is included) — roughly half before it and half after. around-last-seen: the limit replies ending at (and including) the last reply you (the creator) have read in this thread, oldest first. No cursorMessageId needed. If you have never read anything in this thread, this falls back to the same result as latest.

Value in"before-message" | "after-message" | "around-last-seen" | "around-message" | "from-start" | "latest"
cursorMessageId?string

The reply to anchor the fetch on — never the thread-root message itself, which is always messageId in the path, not this field. Required for every mode except from-start, latest, and around-last-seen. A cursorMessageId that does not exist in this thread fails with a 404.

limit?number

Maximum number of replies to return. Defaults to 10, capped at 100.

Default10

Header Parameters

x-whitelabel-host*string

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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/community/chatrooms/{roomId}/messages/{messageId}/replies?mode=latest" \  -H "x-whitelabel-host: string"
{
  "replies": [
    {
      "_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"
        }
      ],
      "isPinned": false,
      "myReaction": "string"
    }
  ]
}
{
  "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
}