Optimly Developer Documentation

Optimly MCP

Execute BrandVault Publish

In short

Execute one approved brand_vault.publish action that atomically updates any combination of BrandVault text sections, sub-brands, structured competitors, and disambiguation. The publish also refreshes the brand's canonical Optimly-hosted llms.txt.

brand_publish · Approval required · Authentication required

Execute one approved brand_vault.publish action that atomically updates any combination of BrandVault text sections, sub-brands, structured competitors, and disambiguation. The publish also refreshes the brand's canonical Optimly-hosted llms.txt.

When to use

Use only after the aggregate publish payload has an active approval. Do not resend the payload; pass only the approved action, approval, idempotency key, and actor.

Access

Approved access with manage_brand_vault permission and a valid approval

Parameters

ParameterTypeRequiredDescription
action_iduuidYesApproved brand_vault.publish execution action.
approval_iduuidYesApproval bound to the exact aggregate publish payload.
idempotency_keystringYesPermanent single-use idempotency key for this publish.
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

Execute the approved BrandVault publish for our ICP and disambiguation update.

Example request

{
  "action_id": "00000000-0000-4000-8000-000000000001",
  "approval_id": "00000000-0000-4000-8000-000000000002",
  "idempotency_key": "vault-publish-2026-08",
  "actor": {
    "type": "human",
    "id": "user_123"
  }
}

Side effects and safety

Writes verified BrandVault data across all supplied collections, records an audit event, consumes the approval, and refreshes the canonical llms.txt. Reusing the idempotency key returns the original result.