bulk_cases_patch
Apply a case-wide action to multiple Pega cases in a single request using the PATCH API. Supports synchronous execution in Infinity and asynchronous in Launchpad.
Instructions
Perform case action on multiple cases simultaneously using PATCH /api/application/v2/cases endpoint. In Infinity, actions are performed synchronously. In Launchpad, actions are performed asynchronously in the background. Only supports case-wide actions that update cases directly - assignment-level actions like Transfer and Adjust Assignment SLA are not supported.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actionID | Yes | Action ID for case/stage action (Example: "pyUpdateCaseDetails", "pyApproval"). CRITICAL: Action IDs are CASE-SENSITIVE and have no spaces even if display names do ("Edit details" → "pyUpdateCaseDetails"). Use get_case to find correct ID from availableActions array - use "ID" field not "name" field. This action must be a case-wide action that updates cases directly. | |
| cases | Yes | Array of case objects to perform the action on. Each case object must contain an ID property with the full case handle. Cannot be empty. | |
| runningMode | No | Execution mode for Launchpad only. "async" schedules the action to be performed in the background rather than immediately. Not applicable for Infinity which always executes synchronously. Currently, only async runningMode is implemented in Launchpad. | |
| content | No | A map of scalar properties and embedded page properties to be set during action execution. Same format as single case action content. | |
| pageInstructions | No | Optional list of page-related operations for embedded pages, page lists, or page groups. Required for setting embedded page references. | |
| attachments | No | A list of attachments to be added to specific attachment fields during action execution. | |
| sessionCredentials | No | Optional session-specific credentials. If not provided, uses environment variables. Supports two authentication modes: (1) OAuth mode - provide baseUrl, clientId, and clientSecret, or (2) Token mode - provide baseUrl and accessToken. |