Optimly Developer Documentation

Optimly MCP

Execute Business Profile Update

In short

Execute one exactly approved Business Profile mutation. The call atomically starts the action and consumes its approval.

brand_update · Approval required · Authentication required

Execute one exactly approved Business Profile mutation. The call atomically starts the action and consumes its approval.

When to use

Use only after the exact mutation payload has an active approval.

Access

Approved access with manage_brand_vault permission and a valid approval

Parameters

ParameterTypeRequiredDescription
section_keystringYesBusiness Profile section. Allowed values: primary_tagline, company_category, target_industry, voice_tone, core_entity, icp, core_problem_solved, unique_advantage, differentiation, use_cases, core_capabilities, skus, pricing, direct_competitors, competitive_differentiation.
contentstringYesApproved replacement content; maximum 5,000 characters.
action_iduuidYesApproved execution action.
approval_iduuidYesApproval bound to the exact action payload.
idempotency_keystringYesPermanent single-use key; minimum eight characters.
actor{ type, id }YesActor identity; type is human, agent, or system.

Example prompt

Execute the approved Business Profile tagline update.

Example request

{
  "section_key": "primary_tagline",
  "content": "Trust infrastructure for agentic commerce.",
  "action_id": "00000000-0000-4000-8000-000000000001",
  "approval_id": "00000000-0000-4000-8000-000000000002",
  "idempotency_key": "tagline-update-2026-07",
  "actor": {
    "type": "human",
    "id": "user_123"
  }
}

Side effects and safety

Writes verified Business Profile data, records an audit event, starts the action, and consumes the approval. Reusing the idempotency key returns the original result rather than performing the mutation twice.