Skip to content

Function: getContextsForField() ​

ts
function getContextsForField(
   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/issueCustomFieldContexts.ts:43

Returns a paginated list of contexts for a custom field. Contexts can be returned as follows:

  • With no other parameters set, all contexts.
  • By defining id only, all contexts from the list of IDs.
  • By defining isAnyIssueType, limit the list of contexts returned to either those that apply to all issue types (true) or those that apply to only a subset of issue types (false)
  • By defining isGlobalContext, limit the list of contexts return to either those that apply to all projects (global contexts) (true) or those that apply to only a subset of projects (false).

Permissions required:Administer Jira global permission. Edit Workflow edit workflow permission

Parameters ​

ParameterTypeDescription
clientClient-
parameters{ contextId?: number[]; fieldId: string; isAnyIssueType?: boolean; isGlobalContext?: boolean; maxResults?: number; startAt?: number; }-
parameters.contextId?number[]The list of context IDs. To include multiple contexts, separate IDs with ampersand: contextId=10000&contextId=10001.
parameters.fieldId?stringThe ID of the custom field.
parameters.isAnyIssueType?booleanWhether to return contexts that apply to all issue types.
parameters.isGlobalContext?booleanWhether to return contexts that apply to all projects.
parameters.maxResults?numberThe maximum number of items to return per page.
parameters.startAt?numberThe index of the first item to return in a page of results (page offset).
options?RequestOptions-

Returns ​

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