BizKitHub
DocsAPI ReferenceTeam Chat/bff/team-chat/messages
getTeam ChatAdmin BFF

/bff/team-chat/messages

No cursor = newest page. beforePosition = older page (scrolling up). afterPosition = newer messages (catch-up / polling); keep fetching while hasMoreAfter. changedSince (+ fromPosition) = messages edited, deleted or re-reacted since an earlier changeCursor. Items are always ascending by position.

Team chatgetBffTeam-chatMessages

Parameters

6 query

Query parameters

· 6
roomIdstringRequired

24-char room id.

Length: 24–24
Exampleexample_roomId
beforePositionstring | numberOptional
Range: 1–∞
afterPositionstring | numberOptional
Range: 0–∞
changedSincestring | numberOptional

changeCursor of an earlier response.

Range: 0–∞
fromPositionstring | numberOptional
Range: 1–∞
limitstring | numberOptional
Range: 1–200

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idstringRequired
positionstring | integerRequired
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
kind"member" | "system"Required
authorUserIdstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
contentstringRequired
systemobject | nullRequired
One of 2:
Variant 1
eventstringRequired
actorUserIdstringRequired
titlestringOptional
userIdstringOptional
userIdsstring[]Optional
positionstring | integerOptional
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
roomIdstringOptional

reminder: room of the message.

previewstringOptional
authorUserIdstring | nullOptional
One of 2:
Variant 1
string
Variant 2
null
issueKeystringOptional

issue-created: the new task.

organisationNamestringOptional
callIdstringOptional
videobooleanOptional
outcome"completed" | "missed" | "declined"Optional
durationSecstring | integerOptional
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
Variant 2
null
attachmentsobject[]Required
Each array item:
tokenstringRequired
filenamestringRequired
sizenumberRequired
contentTypestringRequired
isImagebooleanRequired
clientNoncestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
insertedDatestringRequired
isDeletedbooleanRequired
editedDatestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
replyToobject | nullRequired
One of 2:
Variant 1
idstringRequired
positionstring | integerRequired
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
authorUserIdstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
previewstringRequired
attachmentCountstring | integerRequired
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
isDeletedbooleanRequired
Variant 2
null
reactionsobject[]Required
Each array item:
emojistringRequired
userIdsstring[]Required
mentionsstring[]Required
pinnedDatestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
isForwardedbooleanRequired
pollobject | nullRequired
One of 2:
Variant 1
questionstringRequired
multiplebooleanRequired
anonymousbooleanRequired

Voters are hidden from everybody (voterIds empty).

closedDatestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
totalVotersstring | integerRequired
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
optionsobject[]Required
Each array item:
idstringRequired
textstringRequired
countstring | integerRequired
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
voterIdsstring[]Required
Variant 2
null
linkPreviewobject | nullRequired
One of 2:
Variant 1
urlstringRequired
titlestringRequired
descriptionstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
imagestring | nullRequired
One of 2:
Variant 1
string

Third-party image URL; load it through proxy.bizkithub.com.

Variant 2
null
siteNamestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
Variant 2
null
threadRootIdstring | nullRequired
One of 2:
Variant 1
string

Thread reply: wire id of the root message.

Variant 2
null
threadReplyCountstring | integerRequired

Thread root: live replies.

One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer

Thread root: live replies.

threadLastReplyDatestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
hasMoreBeforebooleanRequired
hasMoreAfterbooleanRequired
lastPositionstring | integerRequired
One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer
changeCursornumberRequired

Pass as changedSince to fetch later edits / deletes / reactions.

Response example

application/json
{
  "items": [
    {
      "id": "example_id",
      "content": "example_content",
      "attachments": [
        {
          "token": "example_token",
          "filename": "example_filename",
          "size": 0,
          "contentType": "example_contentType",
          "isImage": false
        }
      ],
      "insertedDate": "example_insertedDate",
      "isDeleted": false,
      "reactions": [
        {
          "emoji": "example_emoji",
          "userIds": [
            "string"
          ]
        }
      ],
      "mentions": [
        "string"
      ],
      "isForwarded": false
    }
  ],
  "hasMoreBefore": false,
  "hasMoreAfter": false,
  "changeCursor": 0
}

Request example

GET /bff/team-chat/messages

get
curl -X GET "https://api.bizkithub.com/bff/team-chat/messages?roomId=example_roomId" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key