plans

listTasks

List AND grep tasks in a plan. query searches the title, friendlyId and description, not just the title (substring by default; set isRegex:true for a regular expression, caseSensitive:true for exact case). Supports filtering by status, priority, phaseId and parentItemId (a story's tasks in the work hierarchy, say). Every task carries its versionTimestamp, ready for updateTask, so one call here supplies the tokens for a whole batch of updates, and its parent_item_id and parentItem (the item it belongs to in the work hierarchy, or null).

post/tools/listTasks

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/listTasks
  • Auth: HTTP bearer

Request body

planIdstring required
statusstring

Filter by status.

prioritystring

Filter by priority.

phaseIdstring

Filter by phase.

parentItemIdstring

Only the children of this item in the work hierarchy (its UUID or friendly id, such as IMP-12), whatever plan or phase they are in. "none" lists only the items with no parent. The work hierarchy is not the plan outline nesting (setPlanItemParent).

querystring

Grep across title, friendlyId and description. Substring by default; a regular expression when isRegex:true; case-insensitive unless caseSensitive:true.

isRegexboolean

Treat query as a regular expression (grep -E), e.g. "ACME-\d+". Default false (literal substring).

caseSensitiveboolean

Case-sensitive matching. Default false.

sortFieldstring

Sort field. Default: position.

sortAscendingboolean

Sort ascending. Default: true.

limitnumber

Max results (1-100, default 50).

offsetnumber

Pagination offset.

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.