Open Context Protocol is live! 🚀 Read the launch post
conversationsMark

conversationsMark

Sets the read cursor in a channel.

Details

  • Method: POST
  • Path: /conversations.mark
  • Operation ID: conversations_mark

Parameters

{
  "token": {
    "description": "Authentication token. Requires scope: `conversations:write`",
    "required": false,
    "location": "header",
    "type": "string"
  },
  "channel": {
    "description": "Channel or conversation to set the read cursor for.",
    "required": false,
    "location": "formData",
    "type": "string"
  },
  "ts": {
    "description": "Unique identifier of message you want marked as most recently seen in this conversation.",
    "required": false,
    "location": "formData",
    "type": "string"
  }
}

Response Schema

{
  "additionalProperties": false,
  "description": "Schema for successful response conversations.mark method",
  "properties": {
    "ok": {
      "enum": [
        true
      ],
      "title": "default success response",
      "type": "boolean"
    }
  },
  "required": [
    "ok"
  ],
  "title": "conversations.mark success schema",
  "type": "object"
}

Usage

from ocp_agent import OCPAgent

agent = OCPAgent()
await agent.register_api('slack')

# Call this tool
result = await agent.call_tool('conversationsMark', {
    # Add required parameters here
})