Flow actions
Find these in Flow Builder under Action. Each one checks the user’s permissions itself.
Cancel Agent Run
Section titled “Cancel Agent Run”Cancels a run that has not finished.
Apex class: AgentCancelRunAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Run ID | Yes | |
| Reason | No | Why the run is cancelled. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Status | The run status after the request; Cancelled, or unchanged while a running step finishes. |
| Error Message |
Decide Agent Approval
Section titled “Decide Agent Approval”Approves or rejects Agent Approvals assigned to the running user or their queue. Returns an error per request instead of failing the flow, including for decisions this transaction has no capacity left to make.
Apex class: AgentApprovalActions.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Approval ID | Yes | |
| Approved | Yes | True to let the tool run; false to reject it. |
| Comment | No | Optional reason returned to the agent when the call is rejected. At most 1,000 characters are kept. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Next Command ID | |
| Decided | True when Agent Core recorded the decision. |
| Error Message |
Dismiss Agent Operational Issue
Section titled “Dismiss Agent Operational Issue”Closes an open issue you handled, with a reason.
Apex class: AgentDismissIssueAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Issue ID | Yes | |
| Reason | Yes | What you did about the issue. Kept on the issue. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Dismissed | True when the issue was open and is now closed. |
| Error Message |
Get Agent Run Result
Section titled “Get Agent Run Result”Returns the status of a run and its answer: the final answer of a succeeded run, or the latest answer of a conversation waiting for a reply.
Apex class: AgentRunResultAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Run ID | Yes |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Status | Running, Waiting, Paused, Succeeded, Failed, or Cancelled. |
| Output | Final answer of a succeeded run, or the latest answer of a conversation waiting for a reply. Protected values stay as tokens such as {{EMAIL_1_9f2c61ab}} unless the running user has Agent Kernel Trust Resolver. |
| Error Code | |
| Error Message |
Pause Agent Run
Section titled “Pause Agent Run”Pauses a running run before its next step starts. Rescue it to continue.
Apex class: AgentPauseRunAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Run ID | Yes | |
| Reason | No | Why the run is paused. Shown on the run. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Status | The run status after the request. |
| Error Message |
Reconcile Agent Tool Call
Section titled “Reconcile Agent Tool Call”Records what an outside system shows for a tool call whose outcome is Unknown.
Apex class: AgentReconcileToolCallAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Run ID | Yes | |
| Decision | Yes | ConfirmSucceeded, ConfirmFailed, or Retry. |
| Reason | Yes | What you checked in the outside system. |
| Confirmed Output | No | For ConfirmSucceeded: the call’s result as a JSON object. |
| Failure Message | No | For ConfirmFailed: what went wrong. The agent sees it. |
| Safe to Retry | No | For Retry: true only when repeating the call cannot do the work twice. |
| Pause Run | No | For ConfirmFailed: true to pause the run instead of telling the agent. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Status | The run status after the decision. |
| Error Message |
Reply to Agent Run
Section titled “Reply to Agent Run”Sends a person’s next message to a conversational agent run that is waiting for their reply. Read the answer with Get Agent Run Result.
Apex class: AgentReplyRunAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Run ID | Yes | |
| Message | Yes | The person’s next message to the agent. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Status | The run status after the reply: Running while the agent answers, or Paused when its budget is spent. |
| Error Message |
Rescue Agent Run
Section titled “Rescue Agent Run”Continues a paused run, optionally with your guidance.
Apex class: AgentRescueRunAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Run ID | Yes | |
| Guidance | No | What the agent should do differently. Reaches the model as operator guidance. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Next Command ID | The step the run continues with. |
| Error Message |
Resume Agent Wait
Section titled “Resume Agent Wait”Gives a waiting agent tool the outside system’s answer, using the resume key the tool handed out.
Apex class: AgentResumeWaitAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Resume Key | Yes | The key the waiting tool gave the outside system. Treat it as a secret. |
| Payload | Yes | The outside system’s answer as JSON that matches the wait’s resume schema. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Resumed | True when the run continues with this answer. |
| Error Message |
Start Agent Run
Section titled “Start Agent Run”Starts one agent run per request. Returns an error per request instead of failing the flow.
Apex class: AgentStartRunAction.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Agent Developer Name | Yes | Developer name of an active agent shared with the running user. |
| Input | No | What the agent should do, as text or JSON. |
| Anchor Record ID | No | The record the run is about. Both the running user and the agent must be able to read it. |
| Parent Run ID | No | Optional run this one continues, such as the previous step of a chain. When the parent is limited to a person, this run keeps the same limit. |
| Correlation Key | No | Recommended in record-triggered flows. Repeating a start with the same key returns the existing run instead of starting another, so a flow that fires twice starts one run. Example: the record Id plus a step name. |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Run ID | |
| Started | True when the run exists now. |
| Queued | True when the start continues shortly in the background because this transaction reached its limits. |
| Error Message |
Verify Agent Execution Identity
Section titled “Verify Agent Execution Identity”Signs in through the identity’s Named Credential and checks that it lands on the selected user. Run it before any record changes in the same transaction.
Apex class: AgentExecutionIdentityVerifier.
Inputs
Section titled “Inputs”| Name | Required | Description |
|---|---|---|
| Agent Execution Identity ID | Yes |
Outputs
Section titled “Outputs”| Name | Description |
|---|---|
| Verified | True when the Named Credential signs in as the selected user and that user can run Core work. |
| Message | Verified, or the problem found and how to fix it. |
Pluto is licensed under the GNU Affero General Public License, version 3 only.