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

# Start typing

> POST /api/v1/comms/conversations/:id/typing — show a typing indicator in an iMessage or SMS conversation.

Show a typing indicator for a conversation. Use this before your agent begins generating a reply.

**Scope:** `comms_send`

```bash theme={null}
curl -X POST "https://osis.co/api/v1/comms/conversations/$CONVERSATION_ID/typing"   -H "Authorization: Bearer $COMMS_API_KEY"   -H "Content-Type: application/json"   -d '{ "active": true }'
```

`active` defaults to `true` when omitted.

```json theme={null}
{ "ok": true, "active": true, "skipped": false, "reason": null }
```

The conversation must belong to the API key's organization and must have an active iMessage/SMS provider thread. For a conversation on another channel, the API returns `409 provider_conversation_unavailable`.

Call [Stop typing](/messages-api/stop-typing) immediately before sending your reply.