Skip to main content
Use registry__search_artifacts when you know a name or topic but do not yet have an artifact handle.
  • Inputs: required query; optional kind, limit, semantic, and session_id; plus rationale when Gateway enables it.
  • Limit: defaults to 50 and accepts at most 500.
  • Returns: matching artifacts visible to the caller.
  • Pasted handle: the query can be a pasted artifact handle; the search reads it and finds that artifact.
  • Meaning fallback: the search falls back to matching by meaning.
  • Paging: the search pages through its matches.
  • Workspace label: a row that names a workspace also names it — its display name and its kind (user_default for a personal workspace, org_default for the account’s shared root, default otherwise) show beside the handle, so you need not call registry__list_workspaces to learn which workspace a row is in. The label appears only for a workspace the caller could already list; archived workspaces are labelled too, and anything else shows the handle alone.
  • Effect: read only.
Use a returned artifact handle with registry__get_artifact or registry__get_related_artifacts.