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

# Mark Conversation Read

> Mark a conversation as read.

Returns the caller's post-clear unread notification total alongside the
status. The clear covers every unread bell row for the thread, so a client
that has paged in only part of its notification list cannot compute the new
badge value itself — it would subtract only the rows it can see and leave the
badge too high. Reporting the total lets the client set it exactly without
refetching the list (which would also race the read replica).



## OpenAPI

````yaml put /communication/conversations/{conversation_id}/read
openapi: 3.1.0
info:
  title: Decoda API
  description: External API documentation for the Decoda Health platform.
  version: '1.0'
servers: []
security: []
paths:
  /communication/conversations/{conversation_id}/read:
    put:
      tags:
        - Social Inbox
      summary: Mark Conversation Read
      description: >-
        Mark a conversation as read.


        Returns the caller's post-clear unread notification total alongside the

        status. The clear covers every unread bell row for the thread, so a
        client

        that has paged in only part of its notification list cannot compute the
        new

        badge value itself — it would subtract only the rows it can see and
        leave the

        badge too high. Reporting the total lets the client set it exactly
        without

        refetching the list (which would also race the read replica).
      operationId: >-
        mark_conversation_read_communication_conversations__conversation_id__read_put
      parameters:
        - name: TENANT
          in: header
          required: true
          schema:
            type: string
            title: Tenant
          description: The tenant you are making this request on behalf of
        - name: API-KEY
          in: header
          required: true
          schema:
            type: string
            title: Api-Key
          description: Your api key
        - name: conversation_id
          in: path
          required: true
          schema:
            type: string
            title: Conversation Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarkConversationReadResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    MarkConversationReadResponse:
      properties:
        status:
          type: string
          title: Status
        notificationUnreadCount:
          type: integer
          title: Notificationunreadcount
      type: object
      required:
        - status
        - notificationUnreadCount
      title: MarkConversationReadResponse
      description: >-
        Result of marking a social thread read.


        Carries the caller's post-clear unread notification total so the bell
        badge

        can be set to an authoritative number instead of decremented by however
        many

        rows the client happened to have paged in. The clear covers every unread

        ``COMMUNICATION_MESSAGE_RECEIVED`` row for the thread, but a client
        holding

        only the first page can see just a prefix of them, so a client-side
        subtract

        leaves the badge too high until the next fetch.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````