FederatedSearchRequest

The public POST /v1/search body. Existing Store-search fields stay at the top level; federation adds only an opt-out and an opaque continuation.

Type object

Shape

Field	Type	Description
textrequired	string
entity_picker	boolean	Restrict results to document/file titles and live task nodes for an @ picker. This is a query shape over the existing projection, not a stored index. Default `false`
workspaces	array of WorkspaceId	Empty means every workspace the index knows. The caller resolves a profile to this; the index has never heard of one. Default `[]`
excluded_workspaces	array of WorkspaceId	Default `[]`
kinds	array of string	`Kind::as_str()` values, as documents store them. Default `[]`
tags	array of string	Tag names, not `TagId`s - this is a text-search surface and a person types the word they read. A hit's node must carry every one of them, and a name here matches its own descendants too (`fun` matches `fun/home`), so this is node-scoped filtering rather than a term: nothing here is searched for, ranked, or spelled back in [`SearchPage::corrected_query`] ([ADR-207](../../../docs/decisions/ADR-201-225.md#adr-207-tagfilter--a-tag-in-a-query-is-a-node-scoped-filter-not-a-term-and-it-lives-in-candidates-alone)). A surface may fill this directly; a person fills it by typing `#tag` into [`Self::text`], which the store lifts out before it searches. Default `[]`
attributes	array of AttrFilter	Typed attribute filters. A hit's node must satisfy every one. One general filter rather than a field per attribute, because a workspace defines its own attributes and declares their types: a wire naming `priority` and `due` explicitly would need a new field for every attribute anybody invents, while `key` + `kinds` serves a custom one on the day it exists. Default `[]`
sort	SearchSort	Default `"relevance"`
lifecycle	LifecycleFilter	Default `"live"`
page_size	integer (uint, >= 0)	Clamped by the store; see [`MAX_PAGE_SIZE`]. Default `50`
offset	integer (uint, >= 0)	Default `0`
request_seq	integer (uint64, >= 0)	Copied to the response, so a surface typing quickly can drop an answer to a keystroke it has already moved past. Default `0`
include_facets	boolean	Default `false`
recent_queries	integer (uint, >= 0) or null	Default `null`
include_ai	boolean	Default `true`
cursor	string or null	Default `null`
profile	ProfileId or null	Only this profile's chats among the AI results (AI schema 13): a window searches its own profile's. Absent searches every profile's, each hit naming its own. The Store results are scoped by `workspaces`, as before.

Example

{
  "text": "string",
  "entity_picker": false,
  "workspaces": [],
  "excluded_workspaces": [],
  "kinds": [],
  "tags": [],
  "attributes": [],
  "sort": "relevance",
  "lifecycle": "live",
  "page_size": 50,
  "offset": 0,
  "request_seq": 0,
  "include_facets": false,
  "recent_queries": 0,
  "include_ai": true,
  "cursor": "string",
  "profile": "00000000-0000-4000-8000-000000000000"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/search
Search Store content and finalized AI chats

Generated from contract version 1. Last updated November 12, 2026.