Create Brand Edit
create_brand_editCreate a draft change to an existing brand from instructions, evidence, or exact profile changes. Preparation runs asynchronously and does not change the active brand; exact profile changes may also update related Brand Skill files. When replaces_edit_id is supplied, the existing draft is discarded only after its replacement is ready.
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>",
"base_skill_id": "<base_skill_id>",
"change": "<change>"
},
"name": "create_brand_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| change | Yes | ||
| evidence | No | ||
| 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. | |
| base_skill_id | Yes | Current version_id from get_brand | |
| brand_session_id | Yes | Brand to prepare this draft change for. Use its Brand session ID from list_brands. | |
| replaces_edit_id | No | Edit ID of the draft awaiting approval for the same brand and base version. That draft is discarded only after this replacement is ready. |
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. |