Chats

List active chats for the current workspace

Returns active workspace chats keyed by internal chat records. Use /chats/{chat_id} when you want the canonical Telegram chat id contract.

get/v1/chats

Request

Base URL: https://api.entergram.com (the document declares no server; this is the origin it was published from)
URL: https://api.entergram.com/v1/chats
Auth: API key in header X-API-Key

Query parameters

limitinteger

Number of chats to return per page.

Example:50

offsetinteger

Zero-based offset for pagination.

updated_sincestring

Optional RFC3339 lower bound. Returns chats whose snapshot or last-message date is newer.

Response

Example response

{
  "data": {
    "items": [
      {
        "connectedAccount": {
          "color": "#2563eb",
          "displayName": "Ops Sample",
          "id": "acct_demo_123",
          "username": "ops_sample"
        },
        "description": "Synthetic example chat for API documentation.",
        "id": "chat_demo_123",
        "lastMessage": {
          "id": "123456",
          "sender": {
            "displayName": "David Hngr",
            "id": "580876383"
          },
          "serviceAction": "setMessagesTTL",
          "text": "Please review the sample request.",
          "timestamp": 1774728948,
          "type": "message"
        },
        "lastMessageText": "Please review the sample request.",
        "lastMessageTimestamp": 1774728948,
        "membersCount": 245,
        "name": "Support Queue Alpha",
        "photoUrl": "https://cdn.example.test/chat-photo.png",
        "status": "active",
        "telegramId": "-1000001234567",
        "telegramUsername": "samplecommunity",
        "title": "Community Alpha",
        "type": "group",
        "unreadCount": 4,
        "username": "support_queue_alpha"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.