# List Microsoft Teams chat messages

Canonical URL: https://docs.fuse.init.inc/integrations/microsoft-teams/actions/chat_messages.list

List messages in a chat.

Action ID: `chat_messages.list`
Provider: Microsoft Teams (`microsoft_teams`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `Chat.Read`

## Input schema fields

- `chat_id`
- `cursor`
- `limit`

## Output schema fields

- `messages`
- `messages[]`
- `messages[].id`
- `messages[].body_content`
- `messages[].body_content_type`
- `messages[].from_user_id`
- `messages[].created_at`
- `messages[].web_url`
- `messages[].reply_to_id`
- `next_cursor`

Provider overview: https://docs.fuse.init.inc/integrations/microsoft-teams
Actions index: https://docs.fuse.init.inc/integrations/microsoft-teams/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/microsoft_teams/actions/chat_messages.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/microsoft_teams/actions