Find documents, notes, files and reports in the user's Clarifo workspaces.
in_trash=true lists the trash instead (documents and notes moved there,
newest first), for restore_from_trash.
Searches every workspace the user owns or has been shared, newest first,
unless workspace_id narrows it. Returns metadata and a short preview; read
an item with get_workspace_item. For "what have I written about X", pass
company (the user's analyses linked to it, as on the company page's My
Analysis tab); to ask how X has done since one of them, read it with
view="since". When several items fit the user's words
(same title in different workspaces), show them with workspace and date and
let the user pick. origin says who produced an item when recorded
(automate, clarifo_research, ai_client, chat); no origin means it was not
recorded, not that the user wrote it.
Args:
query: Words matched against titles and document text (all must match).
workspace_id: Limit to one workspace.
types: e.g. ["text"] for editor documents. Valid: text, source,
analysis, search_result, chat_message, report, file,
spreadsheet, visualization, board (data-bound dashboards and
slide packs). Chat messages are left out unless listed here.
only_unfinished: Only items still in progress (processing files, drafts).
sort: updated_desc (default), created_desc, or position (needs workspace_id).
limit: Items per page, 1-100 (default 20).
cursor: next_cursor of the previous page.
company: Company name or ticker (whole word: "Kone" is not
Konecranes); items linked to that company, plus items whose
title names it (company_match "linked" or "title").
published: true for the documents published on clarifo.com and
still up ("my published articles"), false for the rest.
An item's publication says its state and public url; the
page shows what was published, and editing the document
does not change it (publishing is done in Clarifo).
Returns:
{"items": [{"item_id", "workspace_id", "workspace_name", "folder",
"type", "title", "origin", "content_version", "updated_at",
"preview", "editor_url", "match", "publication"}], "total": 334,
"has_more": true, "next_cursor": "..."}