Get Brand Edit
get_brand_editRead a brand edit's progress, requested input, or prepared candidate. Set wait to true to wait while its status is preparing; if the result is still preparing, repeat the same read with wait: true. On supported MCP clients, this call may accept native input and resume preparation when the question and response can be represented completely. Otherwise use continue_brand_edit. Resuming does not change the active brand.
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": {
"edit_id": "<edit_id>"
},
"name": "get_brand_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait while the edit is preparing, until its status changes or the timeout expires. Defaults to false. | |
| edit_id | Yes | Use edit_id returned by create_brand_edit to identify the Brand Edit draft. | |
| timeout | No | How long this read may wait, in seconds, including setup, native-input continuation, and polling. Applies when wait is true. Defaults to and is capped at 45 seconds. | |
| 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. |
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. |