List Chats
Retrieve the list of chats that the user is part of using the Microsoft Teams API.
SKILL.md
Full skill instructions
List Chats
Retrieve the list of chats that the user is part of using the Microsoft Teams API.
API Details
- API Name: Microsoft Teams API
- OpenAPI Ref:
../../openapi/microsoft-teams-openapi.yaml - Endpoint:
GET /chats - operationId:
listChats - Tag: Chats
Sandbox
- Base URL:
http://localhost:8080/rest/microsoft-teams-api/1.0.0
Required Headers
Authorization: Bearer {access_token}
OAuth Scopes
Chat.Read
Parameters
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| $top | integer | No | The number of results to return |
| $filter | string | No | OData filter expression |
| $expand | string | No | OData expand expression |
| $orderby | string | No | OData order by expression |
Example Request
curl -X GET "http://localhost:8080/rest/microsoft-teams-api/1.0.0/chats" \
-H "Authorization: Bearer {access_token}"
Example Response
{
"value": [
{
"id": "19:[email protected]",
"topic": "Project Discussion",
"chatType": "group",
"createdDateTime": "2025-01-15T09:00:00Z"
},
{
"id": "19:[email protected]",
"topic": null,
"chatType": "oneOnOne",
"createdDateTime": "2025-01-10T08:00:00Z"
}
]
}
Instructions
- Obtain a valid access token with the
Chat.Readscope. - Send a GET request to the endpoint.
- Optionally include
$top,$filter,$expand, or$orderbyquery parameters to refine results. - Parse the response to retrieve the list of chats.