search_files
PRIMARY TOOL: Search for files using natural language. Prefer plain natural-language queries because the Razuna Files AI Chat planner handles semantic intent, sorting, limits, and file-type intent. Use API-compatible scoped search only when explicit folder/search_filters/collect_plus values are needed. Valid search_filters ids are folders, extensions, types, tags, keywords, date_added, and date_modified. The Razuna asset grid displays the returned thumbnails. Use thumbnail_url whenever provided, including for documents and URL bookmarks; file type does not determine thumbnail availability. The grid includes expandable descriptions and keywords. In ChatGPT, respond in plain text only and refer to the grid. Never add image groups, carousels, web previews, or a second gallery, even when labeled illustrative. If the client cannot display the grid, use only the exact returned thumbnail URLs and Razuna links. Do not search the web or generate illustrative replacement images. A returned URL is not proof that the client loaded the image; report a preview failure only if observed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default: 1) | |
| query | Yes | Natural language search query. Examples: "show me the latest 10 images added to my workspace", "largest 5 files", "product photos with blue backgrounds", "files with extension pdf in marketing folder", "images uploaded this week". | |
| per_page | No | Number of results per page (default: 20). Max 250 for conversational mode and 50 for API-style scoped mode. | |
| folder_id | No | Optional folder ID for scoped API-style folder search. | |
| collect_plus | No | Optional. Set true to search Collect+ in API-style workspace search mode. | |
| workspace_id | No | Optional workspace ID to scope the Razuna Files AI Chat search. If omitted, conversational mode searches across all accessible workspaces unless a client profile supplies a default workspace. | |
| search_filters | No | Optional API-compatible search filters. When provided, scoped API search mode is used. Do not use content_type, content_type_family, extension, labels, folder, objects, or style as filter ids. | |
| workspace_name | No | Optional workspace name, resolved to workspace_id automatically to scope the Razuna Files AI Chat search. | |
| conversation_id | No | Optional conversation ID from previous search to maintain context for follow-up questions |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes |