Skip to content

Agent Approval

Custom object AgentApproval__c. One human approval for one waiting tool call. Core creates it with the wait, assigns it as the record owner, accepts decisions only from eligible approvers, and closes it on decision, expiry, or cancellation.

FieldAPI nameTypeDescription
Agent CommandAgentCommand__cLookupExact tool command this approval allows or denies.
Agent RunAgentRun__cLookupRun whose tool call waits for this approval.
Agent ToolAgentTool__cLookupThe tool whose call waits for this approval. Pluto Core sets it when the approval opens. Approval processes, notification packages, and reports use it to treat each tool differently without matching on Tool Name.
Approver TypeApproverType__cPicklistHow Core chose the approver, copied from the tool or authorization policy when the approval was requested. Values: User, Queue, Anchor Record Owner, Requester’s Manager, Approval Process.
Closed AtClosedAt__cDateTimeWhen the approval was approved, rejected, expired, or cancelled.
Decided ByDecidedBy__cLookupUser who approved or rejected the tool call.
Decision CommentDecisionComment__cLongTextAreaThe approver’s comment on the decision, with sensitive values replaced by tokens. A rejection comment is also what the agent receives as the tool result.
Expires AtExpiresAt__cDateTimeDeadline for a decision. After it passes, Core applies When Approval Expires.
ReasonReason__cTextWhy Core asked for this approval: the tool setting or the authorization policy reason.
Relayed ByRelayedBy__cLookupApproval channel user that delivered a decision made outside Salesforce records, such as in a native approval process or Slack. Blank when the approver decided directly.
Requested ByRequestedBy__cLookupUser who started the run.
Run RevisionRunRevision__cNumberRun revision at which the approval was requested. A decision applies only while the run is still at this revision.
StatusStatus__cPicklistLifecycle state of the approval. Core closes it when someone decides, the deadline passes, or the run is cancelled. Values: Pending, Approved, Rejected, Expired, Cancelled.
Tool NameToolName__cTextDeveloper name of the tool waiting for approval.
When Approval ExpiresExpiryAction__cPicklistCopied from the tool: what Core does if nobody decides before the deadline. Values: Deny and Continue, Pause for Operator.

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