Skip to main content
Add a user participant to a conversation.

Tool details

FieldValue
Namecreate_conversation_participant
GroupConversations

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "format": "uuid",
      "description": "Conversation identifier that scopes the request."
    },
    "user_id": {
      "type": "string",
      "format": "uuid",
      "description": "Provide the user id."
    },
    "role": {
      "type": "string",
      "enum": [
        "member",
        "viewer"
      ],
      "description": "Provide the role."
    }
  },
  "required": [
    "conversation_id",
    "user_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the create_conversation_participant tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Conversation participant identifier."
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation identifier that owns the participant membership."
    },
    "user_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "User identifier for the participant, or null for non-user actors."
    },
    "role": {
      "type": "string",
      "description": "Participant role within the conversation."
    },
    "last_read_message_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Most recent message identifier marked as read by the participant."
    },
    "notification_preference": {
      "type": "string",
      "description": "Notification delivery preference for this participant."
    },
    "joined_at": {
      "type": "string",
      "description": "Timestamp when the participant joined the conversation."
    }
  },
  "required": [
    "id",
    "conversation_id",
    "user_id",
    "role",
    "last_read_message_id",
    "notification_preference",
    "joined_at"
  ],
  "additionalProperties": false,
  "description": "Conversation participant membership record.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}