> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trychert.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Typing indicators

> POST /api/v1/chats/:id/typing - show or clear typing dots in an existing chat.

Use typing indicators as a UI signal before an agent or automation sends a follow-up. They are best-effort and should not be treated as delivery confirmation.

`POST /api/v1/chats/{id}/typing`

## Request

```bash theme={null}
curl -X POST https://console.trychert.com/api/v1/chats/$CHAT_ID/typing \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "state": "typing" }'
```

Use `"stopped"` to clear the indicator:

```bash theme={null}
curl -X POST https://console.trychert.com/api/v1/chats/$CHAT_ID/typing \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "state": "stopped" }'
```

## Fields

| Field   | Required | Notes                  |
| ------- | -------: | ---------------------- |
| `state` |      Yes | `typing` or `stopped`. |

## Response

```json theme={null}
{
  "status": "sent",
  "chat_id": "0f2d3c1a-8b4e-4f6a-90d2-1a3b4c5d6e7f",
  "state": "typing"
}
```

## Notes

| Behavior             | What it means                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------- |
| Existing chats only  | Create or receive a chat first, then send typing indicators.                                 |
| Pinned line required | Chert sends the signal from the line already attached to the chat.                           |
| Best-effort          | Recipients may not always see typing dots, depending on device state and network conditions. |

## See also

* [Create a chat](/api/chats/create)
* [Send a follow-up](/api/chats/send-message)