find_file_in_folder
Find the first Google Sheet in a folder whose name contains a substring — only spreadsheets match; for any other file type use search_drive_files with rawQuery and parentId.
readGoogle Sheets, Docs & Drive
Call it
In an AI client (MCP)
{
"name": "find_file_in_folder",
"arguments": {
"folderId": "<folderId>",
"nameContains": "<nameContains>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/find_file_in_folder \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"folderId":"<folderId>","nameContains":"<nameContains>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
folderIdrequired | string | Drive folder ID to search within. |
nameContainsrequired | string | Substring to match in file names. |
Result
Every tool answers {notification, data, human_action}; data carries:
fileId— Spreadsheet ID of first match, or null if not found.found— Boolean indicating if a match was found.
Example
find_file_in_folder(folderId="1ABC...", nameContains="report_2026")