# Chat

 - [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`
 - [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`
 - [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:** `
 - [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:** `c
 - [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 ins
 - [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). Where the provider s
 - [GET /v1/chat/messages](https://docs.synqly.com/api-reference/connectors/chat/chat_query_messages.md): Returns all messages across every conversation in the connected workspace or tenant. **Operation ID:** `chat_query_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)
 - [POST /v1/chat/conversations/{conversationId}/messages](https://docs.synqly.com/api-reference/connectors/chat/chat_create_message.md): Posts a message to a conversation as the integration's bot or app, either as a new top-level message or as a reply in a thread. The response carries the message's `uid`, which update_message and delet
 - [POST /v1/chat/direct-messages](https://docs.synqly.com/api-reference/connectors/chat/chat_create_direct_message.md): Sends a direct message to one user, opening the direct conversation if it does not exist yet. The response's `chat_message.conversation_uid` addresses that conversation for later messages and reads. *
 - [POST /v1/chat/conversations/{conversationId}/messages/{messageId}](https://docs.synqly.com/api-reference/connectors/chat/chat_update_message.md): Replaces the text of a message the integration sent. Messages sent by anyone else cannot be updated, and a provider's admin policy can forbid edits. The response can lack `chat_message.parent_uid`; th
 - [DELETE /v1/chat/conversations/{conversationId}/messages/{messageId}](https://docs.synqly.com/api-reference/connectors/chat/chat_delete_message.md): Deletes a message the integration sent. Messages sent by anyone else cannot be deleted, and a provider's admin policy can forbid deletes. **Operation ID:** `chat_delete_message`
