Skip to content

Flow actions

Find these in Flow Builder under Action. Each one checks the user’s permissions itself.

Cancels a run that has not finished.

Apex class: AgentCancelRunAction.

NameRequiredDescription
Run IDYes
ReasonNoWhy the run is cancelled.
NameDescription
StatusThe run status after the request; Cancelled, or unchanged while a running step finishes.
Error Message

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.

NameRequiredDescription
Approval IDYes
ApprovedYesTrue to let the tool run; false to reject it.
CommentNoOptional reason returned to the agent when the call is rejected. At most 1,000 characters are kept.
NameDescription
Next Command ID
DecidedTrue when Agent Core recorded the decision.
Error Message

Closes an open issue you handled, with a reason.

Apex class: AgentDismissIssueAction.

NameRequiredDescription
Issue IDYes
ReasonYesWhat you did about the issue. Kept on the issue.
NameDescription
DismissedTrue when the issue was open and is now closed.
Error Message

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.

NameRequiredDescription
Run IDYes
NameDescription
StatusRunning, Waiting, Paused, Succeeded, Failed, or Cancelled.
OutputFinal 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

Pauses a running run before its next step starts. Rescue it to continue.

Apex class: AgentPauseRunAction.

NameRequiredDescription
Run IDYes
ReasonNoWhy the run is paused. Shown on the run.
NameDescription
StatusThe run status after the request.
Error Message

Records what an outside system shows for a tool call whose outcome is Unknown.

Apex class: AgentReconcileToolCallAction.

NameRequiredDescription
Run IDYes
DecisionYesConfirmSucceeded, ConfirmFailed, or Retry.
ReasonYesWhat you checked in the outside system.
Confirmed OutputNoFor ConfirmSucceeded: the call’s result as a JSON object.
Failure MessageNoFor ConfirmFailed: what went wrong. The agent sees it.
Safe to RetryNoFor Retry: true only when repeating the call cannot do the work twice.
Pause RunNoFor ConfirmFailed: true to pause the run instead of telling the agent.
NameDescription
StatusThe run status after the decision.
Error Message

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.

NameRequiredDescription
Run IDYes
MessageYesThe person’s next message to the agent.
NameDescription
StatusThe run status after the reply: Running while the agent answers, or Paused when its budget is spent.
Error Message

Continues a paused run, optionally with your guidance.

Apex class: AgentRescueRunAction.

NameRequiredDescription
Run IDYes
GuidanceNoWhat the agent should do differently. Reaches the model as operator guidance.
NameDescription
Next Command IDThe step the run continues with.
Error Message

Gives a waiting agent tool the outside system’s answer, using the resume key the tool handed out.

Apex class: AgentResumeWaitAction.

NameRequiredDescription
Resume KeyYesThe key the waiting tool gave the outside system. Treat it as a secret.
PayloadYesThe outside system’s answer as JSON that matches the wait’s resume schema.
NameDescription
ResumedTrue when the run continues with this answer.
Error Message

Starts one agent run per request. Returns an error per request instead of failing the flow.

Apex class: AgentStartRunAction.

NameRequiredDescription
Agent Developer NameYesDeveloper name of an active agent shared with the running user.
InputNoWhat the agent should do, as text or JSON.
Anchor Record IDNoThe record the run is about. Both the running user and the agent must be able to read it.
Parent Run IDNoOptional 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 KeyNoRecommended 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.
NameDescription
Run ID
StartedTrue when the run exists now.
QueuedTrue when the start continues shortly in the background because this transaction reached its limits.
Error Message

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.

NameRequiredDescription
Agent Execution Identity IDYes
NameDescription
VerifiedTrue when the Named Credential signs in as the selected user and that user can run Core work.
MessageVerified, or the problem found and how to fix it.

Pluto is licensed under the GNU Affero General Public License, version 3 only.