Skip to main content
FuseFuse
IntegrationsMicrosoft teamsActions

List Microsoft Teams chats

List chats for the connected user.

Agent markdown

chats.list · Microsoft Teams · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • Chat.ReadBasic

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
cursorstringNominLength 1; maxLength 2048
limitintegerNominimum 1; maximum 100

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
chatsarray<object>Yes
chats[]objectYesadditionalProperties false
chats[].idstringYes
chats[].chat_typestringYesenum oneOnOne | group | meeting
chats[].topicstringNo
next_cursorstringNominLength 1; maxLength 2048

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "chats": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "chat_type": {
            "type": "string",
            "enum": [
              "oneOnOne",
              "group",
              "meeting"
            ]
          },
          "topic": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "chat_type"
        ]
      }
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    }
  },
  "required": [
    "chats"
  ]
}