---
{
  "id": "platform.search.overview",
  "topic": "search",
  "title": "Authorized in-product search overview",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Search queries the user's authorized Arinova resources across explicit buckets; it does not access the public internet.",
  "content": "`arinova.search.query` searches inside Arinova across exactly seven wire-contract buckets: `messages`, `notes`, `memo`, `kanban`, `conversations`, `users`, and `memory`. Every call must provide a non-empty `scopes` array. There is no implicit “all,” and the Agent must not invent another scope. Choose only the buckets implied by the request, then use the live schema for field and limit details. The `users` bucket resolves escaped public display-name or username matches to bounded public fields and stable IDs under the failed-search rate limit.\n\nEach bucket performs its own domain permission checks and returns only resources the Agent may read. Result snippets are bounded. The `memory` bucket contains private Agent memory; because the unified action can include it, the entire action is unavailable on public surfaces. Knowledge never grants a bucket, expands visibility, or bypasses its owner and permission rules.\n\nThis family is in-product search, not internet access. Use the Web family for public online information and `web.search` for a public-web query. A zero-result search does not prove the resource does not exist: the selected scopes may be incomplete, the keywords may not match, or the Agent may lack access. Explain that uncertainty and, when appropriate, retry with corrected scopes or terms. Registry schema, current permissions, snippets, and runtime errors override this card.\n",
  "aliases": [
    "in-product search",
    "search my messages",
    "find in my notes",
    "find an earlier conversation",
    "site search",
    "站內搜尋",
    "在我的筆記找",
    "找之前的對話",
    "全站搜尋"
  ],
  "tags": [
    "search",
    "overview",
    "scopes",
    "permissions",
    "routing"
  ],
  "relatedActions": [
    "arinova.search.query"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/en/kb/search/overview/"
}
---

`arinova.search.query` searches inside Arinova across exactly seven wire-contract buckets: `messages`, `notes`, `memo`, `kanban`, `conversations`, `users`, and `memory`. Every call must provide a non-empty `scopes` array. There is no implicit “all,” and the Agent must not invent another scope. Choose only the buckets implied by the request, then use the live schema for field and limit details. The `users` bucket resolves escaped public display-name or username matches to bounded public fields and stable IDs under the failed-search rate limit.

Each bucket performs its own domain permission checks and returns only resources the Agent may read. Result snippets are bounded. The `memory` bucket contains private Agent memory; because the unified action can include it, the entire action is unavailable on public surfaces. Knowledge never grants a bucket, expands visibility, or bypasses its owner and permission rules.

This family is in-product search, not internet access. Use the Web family for public online information and `web.search` for a public-web query. A zero-result search does not prove the resource does not exist: the selected scopes may be incomplete, the keywords may not match, or the Agent may lack access. Explain that uncertainty and, when appropriate, retry with corrected scopes or terms. Registry schema, current permissions, snippets, and runtime errors override this card.
