---
title: Typing Indicators | API Docs
description: Show and receive typing status in conversations.
---

Typing indicators show recipients that someone is actively composing a message. They create a more natural, real-time feel in conversations.

## Sending typing indicators

Start a typing indicator in a chat to show the recipient that you’re composing a message:

Terminal window

```
# Start typing
curl -X POST https://api.linqapp.com/api/partner/v3/chats/{chat_id}/typing \
  -H "Authorization: Bearer $LINQ_API_KEY"


# Stop typing
curl -X DELETE https://api.linqapp.com/api/partner/v3/chats/{chat_id}/typing \
  -H "Authorization: Bearer $LINQ_API_KEY"
```

```
// Start typing
await client.chats.typing.start(chatId);


// Stop typing
await client.chats.typing.stop(chatId);
```

```
# Start typing
client.chats.typing.start(chat_id)


# Stop typing
client.chats.typing.stop(chat_id)
```

> **Tip:** Send a typing indicator before your application processes a response (e.g., while an AI agent generates a reply). This gives the recipient a natural “someone is typing” experience. The indicator automatically clears when you send the actual message.

## Receiving typing indicators

Subscribe to typing indicator webhooks to know when a recipient is typing:

| Event                           | Description                  |
| ------------------------------- | ---------------------------- |
| `chat.typing_indicator.started` | A participant started typing |
| `chat.typing_indicator.stopped` | A participant stopped typing |

See [Webhooks](/guides/webhooks/index.md) for setup instructions and the [Webhook Events API Reference](/api/resources/webhooks/index.md) for payload schemas.

## Important notes

- **iMessage only** — Typing indicators are an iMessage feature and are not available on RCS or SMS. See [Protocol Selection](/guides/messaging/protocol-selection/index.md) for protocol capabilities.
- **One-to-one chats only** — Typing indicators are **not supported in [group chats](/guides/chats/group-chats/index.md)**. They only work in one-to-one conversations.
- **Auto-clear** — Typing indicators automatically clear when you send a message to the chat.
- **Timeout** — Typing indicators expire after approximately 60 seconds if not refreshed or stopped.

See the [Chats API Reference](/api/resources/chats/index.md) for the full typing indicator endpoint specification.