# Azure Communication Services Chat API

**Canonical:** https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-chat-api/  
**Provider:** Microsoft Azure Communication Services — https://apis.io/providers/microsoft-azure-communication-services/  
**Base URL:** https://{resource}.communication.azure.com/  
**Documentation:** https://learn.microsoft.com/en-us/rest/api/communication/

Azure Communication Services Chat API is one of 10 APIs that [Microsoft Azure Communication Services](https://apis.io/providers/microsoft-azure-communication-services/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Chat and Messaging. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Chat API: create chat threads, manage participants, send and read messages and receipts. 16 operations, data-plane version 2025-03-15, served from the customer's Communication Services resource endpoint.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/chat/threads/{chatThreadId}/readReceipts` | Gets chat message read receipts for a thread. |
| POST | `/chat/threads/{chatThreadId}/readReceipts` | Sends a read receipt event to a thread, on behalf of a user. |
| POST | `/chat/threads/{chatThreadId}/messages` | Sends a message to a thread. |
| GET | `/chat/threads/{chatThreadId}/messages` | Gets a list of messages from a thread. |
| GET | `/chat/threads/{chatThreadId}/messages/{chatMessageId}` | Gets a message by id. |
| PATCH | `/chat/threads/{chatThreadId}/messages/{chatMessageId}` | Updates a message. |
| DELETE | `/chat/threads/{chatThreadId}/messages/{chatMessageId}` | Deletes a message. |
| GET | `/chat/threads/{chatThreadId}/participants` | Gets the participants of a thread. |
| POST | `/chat/threads/{chatThreadId}/participants/:remove` | Remove a participant from a thread. |
| POST | `/chat/threads/{chatThreadId}/participants/:add` | Adds thread participants to a thread. If participants already exist, no change occurs. |
| POST | `/chat/threads` | Creates a chat thread. |
| GET | `/chat/threads` | Gets the list of chat threads of a user. |
| PATCH | `/chat/threads/{chatThreadId}` | Updates a thread's properties. |
| GET | `/chat/threads/{chatThreadId}` | Gets a chat thread's properties. |
| DELETE | `/chat/threads/{chatThreadId}` | Deletes a thread. |
| POST | `/chat/threads/{chatThreadId}/typing` | Posts a typing event to a thread, on behalf of a user. |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/microsoft-azure-communication-services/openapi/microsoft-azure-communication-services-chat-api-openapi.yml
- **OpenAPI** — https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/communication/data-plane/Chat/stable/2025-03-15/communicationserviceschat.json
- **Documentation** — https://learn.microsoft.com/en-us/azure/communication-services/
- **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-chat-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-chat-thread-properties-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-create-chat-thread-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-send-chat-message-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-update-chat-thread-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-chat-message-read-receipts-collection-schema.json

## Other Microsoft Azure Communication Services APIs (9)

- [Azure Communication Services Call Automation API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-callautomation-api/)
- [Azure Communication Services Email API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-email-api/)
- [Azure Communication Services Identity API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-identity-api/)
- [Azure Communication Services Job Router API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-jobrouter-api/)
- [Azure Communication Services Advanced Messaging API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-messages-api/)
- [Azure Communication Services Phone Numbers API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-phonenumbers-api/)
- [Azure Communication Services Rooms API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-rooms-api/)
- [Azure Communication Services SIP Routing API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-siprouting-api/)
- [Azure Communication Services SMS API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-sms-api/)

## Tags

Chat, Messaging

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-chat-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-azure-communication-services/.