Search
Bounded Workspace-scoped content search.
Search Workspace content
/api/v1/workspaces/{workspace_id}/searchReturns a bounded, cursor-paginated page of authorized Project, Task,
Document, Comment, or active Person matches from exactly one Workspace. Exact
identifiers and titles take precedence, followed by title prefixes,
weighted lexical relevance, typo tolerance, and recency. The opaque
cursor preserves that deterministic ordering. Plain-text snippets are
bounded and stripped of control characters; results never expose a raw
engine score or exact total. Archived resources are excluded unless
explicitly included; trashed, purged, and deleted resources remain excluded.
Work is rate-limited and query-time bounded; overload returns a
retryable 503 search_unavailable with Retry-After.
Native bearer access is limited to title and identifier matches for an
explicit resource_type of project or task, excludes archived resources,
and returns empty snippets. Other types and omitted/duplicate type filters
return 400 for native callers. Browser search retains its full corpus.
Path Parameters
Query Parameters
string <uuid>Restrict matches to this Project. An inaccessible Project produces no results rather than confirming it exists.
stringRestrict matches to one indexed resource type.
projecttaskdocumentcommentpersonboolean·default falseInclude archived resources. Resolved Tasks are included regardless because resolution is not archival.
Responses
stringOpaque version of the first 20 unfiltered non-archived work results, scoped to query and current member. Absent for other filters/page sizes/cursors. Does not include People or prove exhaustive coverage. Discuss rechecks this version on explicit Send.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.