Optimly Developer Documentation

Optimly MCP

Create BrandVault Publish Action

In short

Create one immutable approval proposal that can update every editable BrandVault surface: text sections, sub-brands, structured competitors, and disambiguation. Supplied structured collections are full replacements; omitted collections are preserved.

create_brand_vault_publish_action · Approval required · Authentication required

Create one immutable approval proposal that can update every editable BrandVault surface: text sections, sub-brands, structured competitors, and disambiguation. Supplied structured collections are full replacements; omitted collections are preserved.

When to use

Use for aggregate BrandVault changes. After approval, execute with brand_publish, which also refreshes the canonical llms.txt.

Access

Approved access with manage_brand_vault permission

Parameters

ParameterTypeRequiredDescription
payload{ sections, sub_brands, competitors, disambiguation }YesImmutable aggregate BrandVault mutation. Include at least one collection. sections accepts [{ section_key, content, publish_state? }] or shorthand { section_key: content }. Disambiguation is patch-shaped.
instructionstringYesHuman-readable instruction.
risk_levelstringYesAssessed risk. Allowed values: low, medium, high.
payload_previewstringYesHuman-readable payload preview.
idempotency_keystringYesPermanent single-use key.
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

Propose a BrandVault publish that updates our ICP section and disambiguation together.

Side effects and safety

Creates an immutable aggregate proposal in the execution ledger.