Search Items

Search for files and folders by name or other criteria

Parameters

ParameterTypeRequiredDescription
querystringRequiredSearch query string
folder_idstringOptionalLimit search to specific folder and its subfolders
item_typesarrayOptionalFilter by item type (File, Folder, or both)
creator_idstringOptionalFilter by creator user ID
create_start_datestringOptionalFilter by creation date (start, ISO 8601)
create_end_datestringOptionalFilter by creation date (end, ISO 8601)
item_name_onlybooleanOptionalSearch only in item names (not content)
topnumberOptionalMaximum number of results (default 50)

Examples

MCP Tool Call

{
  "name": "sharefile_searchItems",
  "arguments": {
    "query": "example",
    "folder_id": "example",
    "item_types": "example",
    "creator_id": "example",
    "create_start_date": "example",
    "create_end_date": "example",
    "item_name_only": true,
    "top": 12345,
    "summary_only": true
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/sharefile/searchItems \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "example",
  "folder_id": "example",
  "item_types": "example",
  "creator_id": "example",
  "create_start_date": "example",
  "create_end_date": "example",
  "item_name_only": true,
  "top": 12345,
  "summary_only": true
}'