Processes

Service for managing and executing UiPath Automation Processes.

Processes (also known as automations or workflows) are the core units of automation in UiPath, representing sequences of activities that perform specific business tasks. UiPath Processes Guide

Usage¶

Prerequisites: Initialize the SDK first - see Getting Started

import { Processes } from '@uipath/uipath-typescript/processes';

const processes = new Processes(sdk);
const allProcesses = await processes.getAll();

Methods¶

getAll()¶

getAll<T>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ProcessGetResponse> : NonPaginatedResponse<ProcessGetResponse>>;

Gets all processes across folders with optional filtering Returns a NonPaginatedResponse with data and totalCount when no pagination parameters are provided, or a PaginatedResponse when any pagination parameter is provided

Type Parameters¶

Type Parameter	Default type
`T` extends `ProcessGetAllOptions`	`ProcessGetAllOptions`

Parameters¶

Parameter	Type	Description
`options?`	`T`	Query options including optional folderId and pagination options

Returns¶

Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ProcessGetResponse> : NonPaginatedResponse<ProcessGetResponse>>

Promise resolving to either an array of processes NonPaginatedResponse or a PaginatedResponse when pagination options are used. ProcessGetResponse

Example¶

// Standard array return
const allProcesses = await processes.getAll();

// Get processes within a specific folder
const folderProcesses = await processes.getAll({
  folderId: <folderId>
});

// Get processes with filtering
const filteredProcesses = await processes.getAll({
  filter: "name eq 'MyProcess'"
});

// First page with pagination
const page1 = await processes.getAll({ pageSize: 10 });

// Navigate using cursor
if (page1.hasNextPage) {
  const page2 = await processes.getAll({ cursor: page1.nextCursor });
}

// Jump to specific page
const page5 = await processes.getAll({
  jumpToPage: 5,
  pageSize: 10
});

getById()¶

getById(
   id: number, 
   folderId: number, 
   options?: BaseOptions): Promise<ProcessGetResponse>;

Gets a single process by ID

Parameters¶

Parameter	Type	Description
`id`	`number`	Process ID
`folderId`	`number`	Required folder ID
`options?`	`BaseOptions`	Optional query parameters

Returns¶

Promise<ProcessGetResponse>

Promise resolving to a single process ProcessGetResponse

Example¶

// Get process by ID
const process = await processes.getById(<processId>, <folderId>);

start()¶

start(
   request: ProcessStartRequest, 
   folderId: number, 
   options?: RequestOptions): Promise<ProcessStartResponse[]>;

Starts a process with the specified configuration

Parameters¶

Parameter	Type	Description
`request`	`ProcessStartRequest`	Process start configuration
`folderId`	`number`	Required folder ID
`options?`	`RequestOptions`	Optional request options

Returns¶

Promise<ProcessStartResponse[]>

Promise resolving to array of started process instances ProcessStartResponse

Example¶

// Start a process by process key
const result = await processes.start({
  processKey: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}, <folderId>); // folderId is required

// Start a process by name with specific robots
const result = await processes.start({
  processName: "MyProcess"
}, <folderId>); // folderId is required