Skip to content

Function: searchStatuses() ​

ts
function searchStatuses(
   client, 
   parameters?, 
   options?
): Promise<{
[key: string]: unknown;
  isLast?: boolean;
  maxResults?: number;
  nextPage?: string;
  self?: string;
  startAt?: number;
  total?: number;
  values?: object[];
}>;

Defined in: src/cloud/api/status.ts:161

Returns a paginated list of statuses that match a search on name or project.

Permissions required:

Parameters ​

ParameterTypeDescription
clientClient-
parameters?{ includeGlobalStatuses?: boolean; maxResults?: number; projectId?: string; searchString?: string; startAt?: number; statusCategory?: string; }-
parameters.includeGlobalStatuses?booleanWhether to include global statuses (scope = null, not tied to any project) in the response. Defaults to false. Only relevant for project scoped queries.
parameters.maxResults?numberThe maximum number of items to return per page.
parameters.projectId?stringThe project the status is part of or null for global statuses.
parameters.searchString?stringTerm to match status names against or null to search for all statuses in the search scope.
parameters.startAt?numberThe index of the first item to return in a page of results (page offset).
parameters.statusCategory?stringCategory of the status to filter by. The supported values are: TODO, IN_PROGRESS, and DONE.
options?RequestOptions-

Returns ​

Promise<{ [key: string]: unknown; isLast?: boolean; maxResults?: number; nextPage?: string; self?: string; startAt?: number; total?: number; values?: object[]; }>