Optimly Developer Documentation

Optimly MCP

Revoke Action Approval

In short

Revoke a pending or unused approval before execution starts.

revoke_action_approval · Approval required · Authentication required

Revoke a pending or unused approval before execution starts.

When to use

Use when a proposed action should no longer run, before anything has executed against the approval.

Access

Approved access with approval-management permission

Parameters

ParameterTypeRequiredDescription
approval_iduuidYesApproval to revoke.
reasonstringYesWhy the approval is being revoked.
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

Revoke the pending approval for the pricing section update — the plan changed.

Side effects and safety

Invalidates the approval. Bound actions can no longer execute against it.