Get conversation read state - Veryfront

Get the current read cursor and unread count for the authenticated user in a conversation.

Tool details

Field	Value
Name	`get_conversation_read_state`
Group	Conversations

Playground

Input schema

input-schema.json

{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "format": "uuid",
      "description": "Conversation identifier that scopes the request."
    }
  },
  "required": [
    "conversation_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the get_conversation_read_state tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

output-schema.json

{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "description": "Conversation identifier."
    },
    "last_read_message_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Most recent message marked as read in the conversation."
    },
    "unread_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of unread messages for the current participant."
    }
  },
  "required": [
    "conversation_id",
    "last_read_message_id",
    "unread_count"
  ],
  "additionalProperties": false,
  "description": "Read-state summary for one conversation.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}