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

# markDirectMessageUnread

> Mark a direct message or thread unread for the viewer, optionally from a specific message

**Required scope:** `write:chats`



**mutation** `markDirectMessageUnread(input: MarkDirectMessageUnreadInput!): MarkDirectMessageUnreadPayload`

## Arguments

**`input`**: `MarkDirectMessageUnreadInput!` (required)

Parameters for MarkDirectMessageUnread

## Returns

`MarkDirectMessageUnreadPayload`

**`clientMutationId`**: `String`

A unique identifier for the client performing the mutation.

---

**`conversation`**: `PrivateConversation`

---

**`errors`**: `[String!]!`

---

**`unreadCount`**: `Int`

Updated unread count (null when the viewer has no membership in the conversation)

## Examples

```graphql Mutation
mutation MarkDirectMessageUnread($input: MarkDirectMessageUnreadInput!) {
  markDirectMessageUnread(input: $input) {
    clientMutationId
    conversation {
      bookmarkedAt
      id
      lastChatAt
      lastMessage {
        actorType
        artifact {
          __typename
        }
        assets {
          __typename
        }
        conversation {
          __typename
        }
        createdAt
        embeddedLink {
          __typename
        }
      }
      messages {
        edges {
          __typename
        }
        nodes {
          __typename
        }
        pageInfo {
          __typename
        }
      }
      participants {
        ambassadorLevel
        ambassadorLevelId
        avatarUrl
        badges {
          __typename
        }
        conversations {
          __typename
        }
        createdAt
      }
    }
    errors
    unreadCount
  }
}
```

```json Variables
{
  "input": {
    "conversationId": "id"
  }
}
```

```json Response
{
  "data": {
    "markDirectMessageUnread": {
      "clientMutationId": "string",
      "conversation": {
        "bookmarkedAt": "value",
        "id": "id",
        "lastChatAt": "value",
        "lastMessage": {
          "actorType": "COHOST",
          "artifact": {
            "__typename": "Artifact"
          },
          "assets": [
            {
              "__typename": "Asset"
            }
          ],
          "conversation": {
            "__typename": "ConversationThread"
          },
          "createdAt": "value",
          "embeddedLink": {
            "__typename": "EmbeddedLink"
          }
        },
        "messages": {
          "edges": [
            {
              "__typename": "PrivateMessageEdge"
            }
          ],
          "nodes": [
            {
              "__typename": "PrivateMessage"
            }
          ],
          "pageInfo": {
            "__typename": "PageInfo"
          }
        },
        "participants": [
          {
            "ambassadorLevel": "string",
            "ambassadorLevelId": 1,
            "avatarUrl": "string",
            "badges": [
              {
                "__typename": "Badge"
              }
            ],
            "conversations": {
              "__typename": "PublicConversationConnection"
            },
            "createdAt": "value"
          }
        ]
      },
      "errors": [
        "string"
      ],
      "unreadCount": 1
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.