Apply Brand Edit
apply_brand_editActivate a prepared brand edit candidate. This is the operation that changes the active brand to the generated candidate. The edit must have status awaiting_approval; repeating the call on an applied edit returns it again. An edit goes stale and cannot be applied once the active brand has changed; create a new edit from the latest brand instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"brand_session_id": "<brand_session_id>",
"edit_id": "<edit_id>"
},
"name": "apply_brand_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| edit_id | Yes | Use edit_id returned by create_brand_edit to identify the Brand Edit draft. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| brand_session_id | Yes | Brand session ID from `list_brands` for the brand being edited. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | Yes | ||
| status | Yes | ||
| target | Yes | ||
| edit_id | Yes | ||
| change_set | Yes | Differences between the base Brand Skill and the prepared candidate, or null before a candidate exists. | |
| created_at | Yes | ||
| updated_at | Yes | ||
| interaction | Yes | The current request for user input, or null when no response is requested. | |
| replacement | Yes | ||
| base_skill_id | Yes | ||
| change_summary | Yes | A summary of the candidate's proposed changes, or null when no summary is available. | |
| status_message | Yes | An explanation of the edit's current status; a prepared candidate does not change the active brand until applied. | |
| target_profile | Yes | The candidate's brand profile, which becomes active only on Apply, or null before a candidate exists. | |
| brand_session_id | Yes | ||
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |