> ## 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 Fax Read

> Flip the fax row to read for the whole tenant and clear notifications.

Mirrors the chat read pattern: the Fax row carries shared read state, so
opening it clears every provider's FAX_RECEIVED notification row at once.
Idempotent and first-writer-wins — the predicate ``read_date IS NULL`` is
pushed into SQL so the first concurrent open's timestamp survives later
duplicates, preserving the audit trail (lab acknowledgement, SLA timing).



## OpenAPI

````yaml post /faxes/{fax_id}/mark-read
openapi: 3.1.0
info:
  title: Decoda API
  description: External API documentation for the Decoda Health platform.
  version: '1.0'
servers: []
security: []
paths:
  /faxes/{fax_id}/mark-read:
    post:
      tags:
        - Faxes
      summary: Mark Fax Read
      description: >-
        Flip the fax row to read for the whole tenant and clear notifications.


        Mirrors the chat read pattern: the Fax row carries shared read state, so

        opening it clears every provider's FAX_RECEIVED notification row at
        once.

        Idempotent and first-writer-wins — the predicate ``read_date IS NULL``
        is

        pushed into SQL so the first concurrent open's timestamp survives later

        duplicates, preserving the audit trail (lab acknowledgement, SLA
        timing).
      operationId: mark_fax_read_faxes__fax_id__mark_read_post
      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: fax_id
          in: path
          required: true
          schema:
            type: string
            title: Fax Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FaxListItem'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    FaxListItem:
      properties:
        id:
          type: string
          title: Id
        direction:
          $ref: '#/components/schemas/FaxDirection'
        status:
          $ref: '#/components/schemas/FaxStatus'
        faxContact:
          anyOf:
            - $ref: '#/components/schemas/FaxContactResponse'
            - type: 'null'
        phoneNumberId:
          anyOf:
            - type: string
            - type: 'null'
          title: Phonenumberid
        phoneNumberE164:
          anyOf:
            - type: string
            - type: 'null'
          title: Phonenumbere164
        numPages:
          anyOf:
            - type: integer
            - type: 'null'
          title: Numpages
        sentAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Sentat
        completedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completedat
        createdDate:
          type: string
          format: date-time
          title: Createddate
        readDate:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Readdate
      type: object
      required:
        - id
        - direction
        - status
        - faxContact
        - phoneNumberId
        - phoneNumberE164
        - numPages
        - sentAt
        - completedAt
        - createdDate
      title: FaxListItem
      description: Compact fax row for list views.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FaxDirection:
      type: string
      enum:
        - OUTBOUND
        - INBOUND
      title: FaxDirection
      description: >-
        Direction of a fax. INBOUND is defined now so inbound work later just
        adds rows.
    FaxStatus:
      type: string
      enum:
        - QUEUED
        - SENDING
        - DELIVERED
        - FAILED
        - CANCELED
        - NO_ANSWER
        - BUSY
      title: FaxStatus
      description: >-
        Lifecycle status of a fax. Values mirror SignalWire's LaML fax status
        values.
    FaxContactResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        faxNumber:
          type: string
          title: Faxnumber
        organization:
          anyOf:
            - type: string
            - type: 'null'
          title: Organization
        notes:
          anyOf:
            - type: string
            - type: 'null'
          title: Notes
        addressLineOne:
          anyOf:
            - type: string
            - type: 'null'
          title: Addresslineone
        addressLineTwo:
          anyOf:
            - type: string
            - type: 'null'
          title: Addresslinetwo
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: State
        zipCode:
          anyOf:
            - type: string
            - type: 'null'
          title: Zipcode
        createdByUserId:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdbyuserid
      type: object
      required:
        - id
        - name
        - faxNumber
        - organization
        - notes
        - addressLineOne
        - addressLineTwo
        - city
        - state
        - zipCode
        - createdByUserId
      title: FaxContactResponse
    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

````