ProjectTaskAnalysisAction
Query and monitor the status of project tasks for a project, milestone, individual project task, or parent project task. This action fails for objects other than Project, Milestone or Project Task.
| Property | Value |
|---|
| Label | Query Project Tasks for Specified Records |
| Category | — |
| Since | Winter 2026 |
| Read-only | Yes |
| Supports Agents | Yes |
| Supports Flows | No |
| Async Action | No |
| Keywords | project task status, over-allocation, resourcing, blocked tasks |
Request Parameters
| Field | Type | Label | Description | Required |
|---|
objectIds | List<Id> | Object IDs | Salesforce record IDs of the project, milestone, individual project task, or parent project task records to analyze. | No |
includeOverAllocatedAnalysis | Boolean | Include OverAllocated Analysis | When true, includes over-allocation analysis for resources on project tasks. | No |
searchObjectName | String | Search Object Name | A full or partial name typed by the user to search by. Use searchObjectType to specify which object to search. | No |
searchObjectType | String | Search Object Type | The API name of the object to search by name when searchObjectName is provided. Provide the Project object API name to search projects, or the Project Task object API name to search project tasks. | No |
maxTaskDisplayCount | Integer | Max Task Display Count | Maximum number of project tasks to return. Defaults to 10 if not specified. | No |
Response Parameters
| Field | Type | Label | Description | Required |
|---|
errorMessage | String | Error Message | Error message if the action execution encounters any issues. | No |
projectTaskActionResponsesInJson | List<String> | Project Task Analysis Results | The results of the project task analysis | No |
projectTaskAnalysisResultsCount | SmartActionRecordDataCount | Project Task Analysis Results Count | The original and returned counts of Project Task Analysis Results. | No |
candidateSObjects | List<String> | Candidate SObjects | Records matching the name search, each serialized as a JSON string. | No |
overAllocatedTasksInJson | List<String> | OverAllocated Tasks JSON | The over-allocated tasks serialized as JSON strings. Only populated when includeOverAllocatedAnalysis is true. | No |
overAllocatedTaskCount | SmartActionRecordDataCount | OverAllocated Task Count | The original and returned counts of over-allocated tasks, indicating whether the list was truncated. Only populated when includeOverAllocatedAnalysis is true. | No |
| 