SplitAssignmentToAssignmentAction
Splits an existing assignment into two assignments at the given start date. The source assignment end date is truncated to the day before the start date. The new segment is assigned to the specified resource.
| Property | Value |
|---|
| Label | Split Assignment to Assignment |
| Category | Resource Management |
| Since | Summer 2026 |
| Read-only | No |
| Supports Agents | Yes |
| Supports Flows | No |
| Async Action | No |
| Keywords | divide, reassign, reallocate, handover |
Request Parameters
| Field | Type | Label | Description | Required |
|---|
assignmentId | Id | Assignment ID | The ID of the assignment to split. The source assignment end date is set to the day before the start date. | Yes |
resourceId | Id | Resource ID | The ID of the resource (Contact record) to assign to the new split assignment segment. | Yes |
startDate | Date | Start Date | The start date of the new assignment. The source assignment end date is set to the day before this date. | Yes |
newAssignmentName | String | New Assignment Name | An optional name for the new assignment segment. If not provided, a default name is generated. | No |
Response Parameters
| Field | Type | Label | Description | Required |
|---|
assignmentId | Id | Assignment ID | The ID of the newly created assignment produced by the split. Null when success is false. | No |
assignmentName | String | Assignment Name | The name of the newly created assignment. Null when success is false. | No |
status | String | Status | The status of the newly created assignment. Null when success is false. | No |
startDate | Date | Start Date | The start date of the newly created assignment. Null when success is false. | No |
endDate | Date | End Date | The end date of the newly created assignment. Null when success is false. | No |
resourceId | Id | Resource ID | The ID of the resource (Contact) assigned to the newly created assignment. Null when success is false. | No |
success | Boolean | Success | True when the assignment was split successfully; false when an error occurred. | No |
errorMessage | String | Error Message | The error message describing why the split failed. Null when success is true. | No |
| 