find_or_create_workroom_thread
Find or create a Workroom DM thread between a merchant user and an AI colleague. Use this when an inbound event deserves owner attention but no threadId was provided. This only prepares an internal Workroom channel.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agentId": "<agentId>"
},
"name": "find_or_create_workroom_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Optional title if a new thread is created | |
| userId | No | Merchant user ID to notify. Defaults to the current MCP user when omitted. | |
| agentId | Yes | AI colleague ID for the Workroom DM |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Tool result payload — shape varies per tool, see the tool description | |
| summary | Yes | One-line human-readable summary of the action | |
| renderType | Yes | UI rendering hint for the result |