Optimly MCP
Record Action Started
Record that an external execution action started. Never use for BrandVault updates: brand_update and brand_publish perform the start and approval consumption atomically.
record_action_started · Approval required · Authentication required
Record that an external execution action started. Never use for BrandVault updates: brand_update and brand_publish perform the start and approval consumption atomically.
When to use
Use when execution happens outside Optimly — for example publishing a page on the brand's own CMS — and the ledger should reflect that it began.
Access
Approved access with action-management permission
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action_id | uuid | Yes | Execution action that started. |
actor | { type, id } | Yes | Actor identity; type is human, agent, or system. |
approval_id | uuid | No | Approval consumed by this execution, when required. |
input_summary | object | No | Bounded summary of execution input. |
external_reference | string | No | External system reference. |
external_url | string | No | External URL for the work. |
brand_id | uuid | No | Authorized brand ID. Required when more than one brand is available. |
Example prompt
Record that we started publishing the approved FAQ page on our CMS.
Side effects and safety
Appends a started event to the action's status history.