Optimly Developer Documentation

Optimly MCP

Record Approval Decision

In short

Attest an approver decision with external evidence.

record_approval_decision · Approval required · Authentication required

Attest an approver decision with external evidence.

When to use

Use to record an approved, rejected, or changes_requested decision made by the registered approver, with a durable evidence reference.

Access

Approved access with approval-management permission

Parameters

ParameterTypeRequiredDescription
approval_iduuidYesApproval being decided.
decisionstringYesApprover's decision. Allowed values: approved, rejected, changes_requested.
decided_by_contact_iduuidYesRegistered approver who decided.
reasonstringYesStated reason for the decision.
evidence_refstringYesDurable reference to the decision evidence.
evidence_hashstringYesHash of the decision evidence.
collector_sourcestringYesWhere the decision was collected. Allowed values: optimly, slack, viktor, email, manual.
actor{ type, id }YesActor identity; type is human, agent, or system.
brand_iduuidNoAuthorized brand ID. Required when more than one brand is available.

Example prompt

Record that our approver approved the tagline update, with the Slack thread as evidence.

Side effects and safety

Finalizes the approval state. An approved decision makes the bound actions executable.