Search Documents
search_documentsSearch Vault document metadata and summaries. When X1 has already selected the client and files for this conversation, use that selection without looking up another client. Otherwise, for a named client, pass their known authorized ID as clientId. If you do not know it, first use list_assigned_members with the client's name and use that person's returned id. If more than one person matches, ask which one instead of guessing. Without clientId or client context from X1, the search may use your own household or ask which client you mean; it does not select a client from the query. A member can search by the filename as shown in Vault even when the stored name uses separators. Title and tag metadata can appear before asynchronous body indexing is ready; use the body-content search tools for content and expect a just-saved document to report still indexing with an instruction to try again shortly. Each result includes a document id; an own-Vault result also includes an X1-authored documentUrl for a direct link. Use only that URL, never construct one from an id. On external professional connectors, use get_document_content or get_document_download_url once per document id when those tools are mounted. They require current download permission and household connected-document access, are rate limited, and record each release in household access history. Otherwise open the document in X1. Advisors and scoped specialists search explicitly shared documents plus active visible coordination-thread attachments, while managed-program roles search within their assignment scope.
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": {
"query": "<query>"
},
"name": "search_documents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query | |
| category | No | Filter by category | |
| clientId | No | Authorized client or member ID. Keep any client and file selection supplied by X1. Otherwise, use a known authorized ID or the person's id returned by list_assigned_members. Without this ID or client context from X1, the search may use your own household or ask which client you mean; the query does not select a client. | |
| dateFrom | No | Filter documents uploaded after this date (ISO 8601) |