Optimly MCP
Create Execution Action
Create an immutable, payload-hashed action proposal before requesting approval or recording execution. For a single Business Profile field use capability brand_vault_update with operation brand_vault.update_section and exactly { section_key, content }.
create_execution_action · Approval required · Authentication required
Create an immutable, payload-hashed action proposal before requesting approval or recording execution. For a single Business Profile field use capability brand_vault_update with operation brand_vault.update_section and exactly { section_key, content }.
When to use
Use to propose any governed action. For complete BrandVault coverage prefer create_brand_vault_publish_action, whose schema exposes every accepted field.
Access
Approved access with action-management permission
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
operation | string | Yes | Operation identifier, for example brand_vault.update_section. |
capability | string | Yes | Capability class. Allowed values: publish, amplify, communicate, measure, deploy, retrieve, brand_vault_update, metadata_update. |
integration | string | Yes | Executing integration. |
instruction | string | Yes | Human-readable instruction. |
risk_level | string | Yes | Assessed risk. Allowed values: low, medium, high. |
source_type | string | Yes | Where the action originated. Allowed values: whitespace_candidate, fix_card, brand_vault, manual, measurement, recommendation. |
source_reference | string | No | Agent work item UUID when source_type is recommendation. |
sanitized_payload | string | Yes | Immutable approved payload. |
payload_preview | string | Yes | Human-readable payload preview. |
approval_required | boolean | Yes | Whether the action needs approval before execution. |
idempotency_key | string | Yes | Permanent single-use key. |
actor | { type, id } | Yes | Actor identity; type is human, agent, or system. |
constraints | object | No | Optional execution constraints. |
expected_result | object | No | Expected outcome description. |
approved_facts | object[] | No | Facts already approved for use. |
fix_card_id | string | No | Source fix card, when applicable. |
whitespace_candidate_id | uuid | No | Source whitespace candidate, when applicable. |
brand_id | uuid | No | Authorized brand ID. Required when more than one brand is available. |
Example prompt
Create an action proposal to update our Business Profile tagline.
Side effects and safety
Creates an immutable, payload-hashed proposal in the execution ledger. The payload cannot change after creation.