Class Workflows

Index

Constructors

Methods

createWorkflow createWorkflows deleteInactiveWorkflow getProjectUsagesForWorkflow getWorkflowProjectIssueTypeUsages getWorkflowSchemeUsagesForWorkflow getWorkflowsPaginated readWorkflows searchWorkflows updateWorkflows validateCreateWorkflows validateUpdateWorkflows workflowCapabilities

Constructors

constructor

new Workflows(client: Client): Version2.Workflows
Parameters
- client: Client
Returns Version2.Workflows
- Defined in src/version2/workflows.ts:9

Methods

createWorkflow

createWorkflow<T = Version2Models.WorkflowId>(
parameters: Version2Parameters.CreateWorkflow,
callback: Callback<T>,
): Promise<void>
Creates a workflow. You can define transition rules using the shapes detailed in the following sections. If no transitional rules are specified the default system transition rules are used. Note: This only applies to company-managed scoped workflows. Use bulk create workflows to create both team and company-managed scoped workflows.

Permissions required: Administer Jira global permission.
Type Parameters
- T = Version2Models.WorkflowId
Parameters
- parameters: Version2Parameters.CreateWorkflow
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:21
createWorkflow<T = Version2Models.WorkflowId>(
parameters: Version2Parameters.CreateWorkflow,
callback?: undefined,
): Promise<T>
Creates a workflow. You can define transition rules using the shapes detailed in the following sections. If no transitional rules are specified the default system transition rules are used. Note: This only applies to company-managed scoped workflows. Use bulk create workflows to create both team and company-managed scoped workflows.

Permissions required: Administer Jira global permission.
Type Parameters
- T = Version2Models.WorkflowId
Parameters
- parameters: Version2Parameters.CreateWorkflow
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:35

createWorkflows

createWorkflows<T = Version2Models.WorkflowCreate>(
parameters: Version2Parameters.CreateWorkflows,
callback: Callback<T>,
): Promise<void>
Create workflows and related statuses.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowCreate
Parameters
- parameters: Version2Parameters.CreateWorkflows
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:332
createWorkflows<T = Version2Models.WorkflowCreate>(
parameters: Version2Parameters.CreateWorkflows,
callback?: undefined,
): Promise<T>
Create workflows and related statuses.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowCreate
Parameters
- parameters: Version2Parameters.CreateWorkflows
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:344

deleteInactiveWorkflow

deleteInactiveWorkflow<T = void>(
parameters: string | Version2Parameters.DeleteInactiveWorkflow,
callback: Callback<T>,
): Promise<void>
Deletes a workflow.

The workflow cannot be deleted if it is:
- An active workflow.
- A system workflow.
- Associated with any workflow scheme.
- Associated with any draft workflow scheme.
Permissions required: Administer Jira global permission.
Type Parameters
- T = void
Parameters
- parameters: string | Version2Parameters.DeleteInactiveWorkflow
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:116
deleteInactiveWorkflow<T = void>(
parameters: string | Version2Parameters.DeleteInactiveWorkflow,
callback?: undefined,
): Promise<T>
Deletes a workflow.

The workflow cannot be deleted if it is:
- An active workflow.
- A system workflow.
- Associated with any workflow scheme.
- Associated with any draft workflow scheme.
Permissions required: Administer Jira global permission.
Type Parameters
- T = void
Parameters
- parameters: string | Version2Parameters.DeleteInactiveWorkflow
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:133

getProjectUsagesForWorkflow

getProjectUsagesForWorkflow<T = WorkflowProjectUsageDTO>(
parameters: Version2Parameters.GetProjectUsagesForWorkflow,
callback: Callback<T>,
): Promise<void>
Returns a page of projects using a given workflow.
Type Parameters
- T = WorkflowProjectUsageDTO
Parameters
- parameters: Version2Parameters.GetProjectUsagesForWorkflow
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:178
getProjectUsagesForWorkflow<T = WorkflowProjectUsageDTO>(
parameters: Version2Parameters.GetProjectUsagesForWorkflow,
callback?: undefined,
): Promise<T>
Returns a page of projects using a given workflow.
Type Parameters
- T = WorkflowProjectUsageDTO
Parameters
- parameters: Version2Parameters.GetProjectUsagesForWorkflow
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:183

getWorkflowProjectIssueTypeUsages

getWorkflowProjectIssueTypeUsages<T = WorkflowProjectIssueTypeUsageDTO>(
parameters: Version2Parameters.GetWorkflowProjectIssueTypeUsages,
callback: Callback<T>,
): Promise<void>
Returns a page of issue types using a given workflow within a project.
Type Parameters
- T = WorkflowProjectIssueTypeUsageDTO
Parameters
- parameters: Version2Parameters.GetWorkflowProjectIssueTypeUsages
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:152
getWorkflowProjectIssueTypeUsages<T = WorkflowProjectIssueTypeUsageDTO>(
parameters: Version2Parameters.GetWorkflowProjectIssueTypeUsages,
callback?: undefined,
): Promise<T>
Returns a page of issue types using a given workflow within a project.
Type Parameters
- T = WorkflowProjectIssueTypeUsageDTO
Parameters
- parameters: Version2Parameters.GetWorkflowProjectIssueTypeUsages
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:157

getWorkflowSchemeUsagesForWorkflow

getWorkflowSchemeUsagesForWorkflow<T = WorkflowSchemeUsageDTO>(
parameters: Version2Parameters.GetWorkflowSchemeUsagesForWorkflow,
callback: Callback<T>,
): Promise<void>
Returns a page of workflow schemes using a given workflow.
Type Parameters
- T = WorkflowSchemeUsageDTO
Parameters
- parameters: Version2Parameters.GetWorkflowSchemeUsagesForWorkflow
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:204
getWorkflowSchemeUsagesForWorkflow<T = WorkflowSchemeUsageDTO>(
parameters: Version2Parameters.GetWorkflowSchemeUsagesForWorkflow,
callback?: undefined,
): Promise<T>
Returns a page of workflow schemes using a given workflow.
Type Parameters
- T = WorkflowSchemeUsageDTO
Parameters
- parameters: Version2Parameters.GetWorkflowSchemeUsagesForWorkflow
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:209

getWorkflowsPaginated

getWorkflowsPaginated<T = Version2Models.PageWorkflow>(
parameters: undefined | Version2Parameters.GetWorkflowsPaginated,
callback: Callback<T>,
): Promise<void>
Returns a paginated list of published classic workflows. When workflow names are specified, details of those workflows are returned. Otherwise, all published classic workflows are returned.

This operation does not return next-gen workflows.

Permissions required: Administer Jira global permission.
Type Parameters
- T = Version2Models.PageWorkflow
Parameters
- parameters: undefined | Version2Parameters.GetWorkflowsPaginated
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:64
getWorkflowsPaginated<T = Version2Models.PageWorkflow>(
parameters?: Version2Parameters.GetWorkflowsPaginated,
callback?: undefined,
): Promise<T>
Returns a paginated list of published classic workflows. When workflow names are specified, details of those workflows are returned. Otherwise, all published classic workflows are returned.

This operation does not return next-gen workflows.

Permissions required: Administer Jira global permission.
Type Parameters
- T = Version2Models.PageWorkflow
Parameters
- Optionalparameters: Version2Parameters.GetWorkflowsPaginated
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:78

readWorkflows

readWorkflows<T = Version2Models.WorkflowRead>(
parameters: Version2Parameters.ReadWorkflows,
callback: Callback<T>,
): Promise<void>
Returns a list of workflows and related statuses by providing workflow names, workflow IDs, or project and issue types.

Permissions required:
- Administer Jira global permission to access all, including project-scoped, workflows
- At least one of the Administer projects and View (read-only) workflow project permissions to access project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowRead
Parameters
- parameters: Version2Parameters.ReadWorkflows
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:239
readWorkflows<T = Version2Models.WorkflowRead>(
parameters: Version2Parameters.ReadWorkflows,
callback?: undefined,
): Promise<T>
Returns a list of workflows and related statuses by providing workflow names, workflow IDs, or project and issue types.

Permissions required:
- Administer Jira global permission to access all, including project-scoped, workflows
- At least one of the Administer projects and View (read-only) workflow project permissions to access project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowRead
Parameters
- parameters: Version2Parameters.ReadWorkflows
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:253

searchWorkflows

searchWorkflows<T = Version2Models.WorkflowSearchResponse>(
parameters: undefined | Version2Parameters.SearchWorkflows,
callback: Callback<T>,
): Promise<void>
Returns a paginated list of global and project workflows. If workflow names are specified in query string, details of those workflows are returned. Otherwise, all workflows are returned.

Permissions required:
- Administer Jira global permission to access all, including project-scoped, workflows
- At least one of the Administer projects and View (read-only) workflow project permissions to access project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowSearchResponse
Parameters
- parameters: undefined | Version2Parameters.SearchWorkflows
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:416
searchWorkflows<T = Version2Models.WorkflowSearchResponse>(
parameters?: Version2Parameters.SearchWorkflows,
callback?: undefined,
): Promise<T>
Returns a paginated list of global and project workflows. If workflow names are specified in query string, details of those workflows are returned. Otherwise, all workflows are returned.

Permissions required:
- Administer Jira global permission to access all, including project-scoped, workflows
- At least one of the Administer projects and View (read-only) workflow project permissions to access project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowSearchResponse
Parameters
- Optionalparameters: Version2Parameters.SearchWorkflows
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:431

updateWorkflows

updateWorkflows<T = Version2Models.WorkflowUpdate>(
parameters: Version2Parameters.UpdateWorkflows,
callback: Callback<T>,
): Promise<void>
Update workflows and related statuses.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowUpdate
Parameters
- parameters: Version2Parameters.UpdateWorkflows
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:464
updateWorkflows<T = Version2Models.WorkflowUpdate>(
parameters: Version2Parameters.UpdateWorkflows,
callback?: undefined,
): Promise<T>
Update workflows and related statuses.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowUpdate
Parameters
- parameters: Version2Parameters.UpdateWorkflows
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:476

validateCreateWorkflows

validateCreateWorkflows<T = Version2Models.WorkflowValidationErrorList>(
parameters: Version2Parameters.ValidateCreateWorkflows,
callback: Callback<T>,
): Promise<void>
Validate the payload for bulk create workflows.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowValidationErrorList
Parameters
- parameters: Version2Parameters.ValidateCreateWorkflows
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:373
validateCreateWorkflows<T = Version2Models.WorkflowValidationErrorList>(
parameters: Version2Parameters.ValidateCreateWorkflows,
callback?: undefined,
): Promise<T>
Validate the payload for bulk create workflows.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowValidationErrorList
Parameters
- parameters: Version2Parameters.ValidateCreateWorkflows
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:385

validateUpdateWorkflows

validateUpdateWorkflows<T = Version2Models.WorkflowValidationErrorList>(
parameters: Version2Parameters.ValidateUpdateWorkflows,
callback: Callback<T>,
): Promise<void>
Validate the payload for bulk update workflows.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowValidationErrorList
Parameters
- parameters: Version2Parameters.ValidateUpdateWorkflows
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:507
validateUpdateWorkflows<T = Version2Models.WorkflowValidationErrorList>(
parameters: Version2Parameters.ValidateUpdateWorkflows,
callback?: undefined,
): Promise<T>
Validate the payload for bulk update workflows.

Permissions required:
- Administer Jira project permission to create all, including global-scoped, workflows
- Administer projects project permissions to create project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowValidationErrorList
Parameters
- parameters: Version2Parameters.ValidateUpdateWorkflows
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:519

workflowCapabilities

workflowCapabilities<T = Version2Models.WorkflowCapabilities>(
parameters: Version2Parameters.WorkflowCapabilities,
callback: Callback<T>,
): Promise<void>
Get the list of workflow capabilities for a specific workflow using either the workflow ID, or the project and issue type ID pair. The response includes the scope of the workflow, defined as global/project-based, and a list of project types that the workflow is scoped to. It also includes all rules organised into their broad categories (conditions, validators, actions, triggers, screens) as well as the source location (Atlassian-provided, Connect, Forge).

Permissions required:
- Administer Jira project permission to access all, including global-scoped, workflows
- Administer projects project permissions to access project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowCapabilities
Parameters
- parameters: Version2Parameters.WorkflowCapabilities
- callback: Callback<T>
Returns Promise<void>
- Defined in src/version2/workflows.ts:287
workflowCapabilities<T = Version2Models.WorkflowCapabilities>(
parameters: Version2Parameters.WorkflowCapabilities,
callback?: undefined,
): Promise<T>
Get the list of workflow capabilities for a specific workflow using either the workflow ID, or the project and issue type ID pair. The response includes the scope of the workflow, defined as global/project-based, and a list of project types that the workflow is scoped to. It also includes all rules organised into their broad categories (conditions, validators, actions, triggers, screens) as well as the source location (Atlassian-provided, Connect, Forge).

Permissions required:
- Administer Jira project permission to access all, including global-scoped, workflows
- Administer projects project permissions to access project-scoped workflows
Type Parameters
- T = Version2Models.WorkflowCapabilities
Parameters
- parameters: Version2Parameters.WorkflowCapabilities
- Optionalcallback: undefined
Returns Promise<T>
- Defined in src/version2/workflows.ts:303

Class Workflows

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Version2.Workflows

Methods

createWorkflow

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

createWorkflows

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

deleteInactiveWorkflow

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getProjectUsagesForWorkflow

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getWorkflowProjectIssueTypeUsages

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getWorkflowSchemeUsagesForWorkflow

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

getWorkflowsPaginated

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

readWorkflows

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

searchWorkflows

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

updateWorkflows

Type Parameters

Parameters

Returns Promise<void>

Type Parameters

Parameters

Returns Promise<T>

validateCreateWorkflows