# Chat

## Query Users

 - [GET /v1/chat/users](https://docs.synqly.com/api-reference/connectors/chat/chat_query_users.md): Returns a list of users in the connected workspace or tenant. Used to discover whose conversations can be queried.

Operation ID: chat_query_users

## Query User Conversations

 - [GET /v1/chat/users/{userId}/conversations](https://docs.synqly.com/api-reference/connectors/chat/chat_query_user_conversations.md): Returns a list of conversations scoped to a specific user — DMs, group chats, or (for AI providers) synthesised sessions.

Operation ID: chat_query_user_conversations

## Query User Conversation Members

 - [GET /v1/chat/users/{userId}/conversations/{conversationId}/members](https://docs.synqly.com/api-reference/connectors/chat/chat_query_user_conversation_members.md): Returns the members of a conversation scoped to a specific user. Required for providers where conversations are only addressable via the user (e.g. Teams DMs, Copilot AI sessions).

Operation ID: chat_query_user_conversation_members

## Query User Conversation Messages

 - [GET /v1/chat/users/{userId}/conversations/{conversationId}/messages](https://docs.synqly.com/api-reference/connectors/chat/chat_query_user_conversation_messages.md): Returns messages from a conversation scoped to a specific user. Required for providers where conversations are only addressable via the user (e.g. Teams DMs, Copilot AI sessions).

Operation ID: chat_query_user_conversation_messages

## Query Conversations

 - [GET /v1/chat/conversations](https://docs.synqly.com/api-reference/connectors/chat/chat_query_conversations.md): Returns a list of conversations (channels or workspaces) not scoped to a specific user. Providers that can only enumerate conversations per-user return NotImplemented; use query_user_conversations instead.

Operation ID: chat_query_conversations

## Query Conversation Members

 - [GET /v1/chat/conversations/{conversationId}/members](https://docs.synqly.com/api-reference/connectors/chat/chat_query_conversation_members.md): Returns the members of a specific conversation. Use the user-scoped variant (query_user_conversation_members) for chats that only exist in a user's mailbox (e.g. Teams 1:1 chats).

Operation ID: chat_query_conversation_members

## Query Conversation Messages

 - [GET /v1/chat/conversations/{conversationId}/messages](https://docs.synqly.com/api-reference/connectors/chat/chat_query_conversation_messages.md): Returns messages from a specific conversation. The conversationId must be obtained from query_conversations or query_user_conversations. Use the user-scoped variant (query_user_conversation_messages) for chats that only exist in a user's mailbox.

Operation ID: chat_query_conversation_messages