improvements

searchImprovements

Ranked search over IMPROVEMENTS AND TASKS that matches by meaning as well as by wording. Returns ranked { improvements }, each with a versionTimestamp you can pass straight to updateImprovement without a getImprovement round-trip.

Improvements and tasks are one table (a task is an improvement with is_task=true), so both are searched by default. Pass types:["task"] or types:["improvement"] to narrow to one.

This tool searches improvements and tasks ONLY. To find a document, whiteboard, plan or compliance item by name or friendly id, use kg_search({ query, artefactMetadataOnly: true }) — it matches title + friendly id + uuid across every artefact type and needs no knowledge graph. To search document CONTENT, use listDocuments.

post/tools/searchImprovements

Request

  • Base URL: https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1
  • URL: https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/tools/searchImprovements
  • Auth: HTTP bearer

Request body

querystring required

Search query — meaning, a name fragment, or a friendly id (e.g. "IMP-2", "TAS-7").

typesstring[]

Narrow to one kind. Omit (or pass both) to search improvements and tasks together. Other artefact types are NOT accepted here — use kg_search with artefactMetadataOnly:true for those.

projectIdstring

Limit to a project.

workspaceIdstring

Limit to a workspace.

limitnumber

Max results (default 20, max 50).

Response

Tool result (shape varies per tool — refer to the tool's docs for the exact return value).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.