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

# Mark Typing

> Display the WhatsApp typing indicator to the contact while a reply is being composed.

Shows the WhatsApp typing indicator ("…") to the contact, signalling that
a reply is on the way. Use this when a human agent or external system is
composing a response and you want to keep the contact engaged.

The indicator is anchored to the latest inbound message, which is also
implicitly marked as read. If the conversation has no inbound messages, the
call is a no-op and the conversation is returned unchanged.

<Note>
  WhatsApp automatically dismisses the typing indicator after a short period
  or as soon as the next outbound message is sent. To keep it visible for
  longer, call this endpoint again before it expires.
</Note>


## OpenAPI

````yaml api-reference/openapi.json POST /api/v1/conversations/{id}/typing/
openapi: 3.0.3
info:
  title: Wassist API
  version: 1.0.0
  description: API for building WhatsApp AI agents
servers:
  - url: https://alpha-plagiocephalic-darrell.ngrok-free.dev
    description: Development
security: []
tags:
  - name: Agents
    description: Create and manage AI agents
  - name: Conversations
    description: Chat conversations and messages
  - name: WhatsApp
    description: WhatsApp Business account management
  - name: Contacts
    description: Contact management
  - name: Integrations
    description: Third-party integrations
paths:
  /api/v1/conversations/{id}/typing/:
    post:
      tags:
        - api
      description: >-
        Mark the conversation as typing, Note this will also mark the
        conversation messages as read. This is a WhatsApp limitation, not a
        feature of the API.
      operationId: api_v1_conversations_typing_create
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Conversation:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        contact:
          $ref: '#/components/schemas/ConversationContact'
        activeAgent:
          type: string
          readOnly: true
        whatsappNumber:
          type: string
          readOnly: true
        chatWindowRemainingTime:
          type: string
          readOnly: true
        lastMessage:
          type: string
          readOnly: true
        isHumanTakeover:
          type: string
          readOnly: true
        active:
          type: string
          readOnly: true
        routing:
          type: string
          readOnly: true
        webhookId:
          type: string
          readOnly: true
        routingOverride:
          type: string
          readOnly: true
      required:
        - active
        - activeAgent
        - chatWindowRemainingTime
        - contact
        - id
        - isHumanTakeover
        - lastMessage
        - routing
        - routingOverride
        - webhookId
        - whatsappNumber
    ConversationContact:
      type: object
      properties:
        phoneNumber:
          type: string
        name:
          type: string
          nullable: true
      required:
        - name
        - phoneNumber
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key authentication. Pass your API key in the X-API-Key header.

````