Find a direct-message space
find_direct_messageLocate an existing direct-message space with a specified Google user or email and get its space ID for sending messages. Returns 404 if no DM exists, so use spaces.setup to create one.
Instructions
Finds the EXISTING direct-message space between the authenticated user and another user, returning the space (name spaces/) to send_message into. Returns HTTP 404 when no DM with that user exists yet — this tool cannot create one (creating DMs needs spaces.setup via raw_request). The user can be a Google user id (users/123...) or an email address.
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": {
"user": "<user>"
},
"name": "find_direct_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | Yes | The user — "users/<id>", "users/<email>", or a bare Google user id / email address. |