# Typing

## Set the typing indicator

**post** `/v1/chats/{chat}/typing`

Sets or clears the chat's typing indicator.

**Behavior**

- Live only: the customer sees it as it happens; nothing is recorded.
- Not needed around your own sends: put `typing_lead_ms` on the send
  instead, which shows the indicator for exactly as long as you ask. This
  endpoint is for showing activity while you are still working on a reply.
- No `Idempotency-Key`: the server neither requires nor consults one
  here.

### Path Parameters

- `chat: string`

### Body Parameters

- `state: "start" or "end"`

  `start` shows the customer the typing indicator; `end` clears it. Any other value is a 422 `code` 1066.

  - `"start"`

  - `"end"`

### Example

```http
curl https://messages.api.linqapp.com/v1/chats/$CHAT/typing \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY" \
    -d '{
          "state": "start"
        }'
```

#### Response

```json
{}
```

## Domain Types

### Typing Set Response

- `TypingSetResponse = unknown`

  Typing succeeds with an empty JSON object; we do not wait for Apple to confirm it.