update_creative_concept
Change a creative concept in one all-or-nothing call: its name, brief, framing (persona, desire, awareness, angle) or master, the creatives that join or leave it, and whether it is archived. Only the fields you pass change. Once the concept has creatives its framing is set-once: a blank field can be filled, a set one can’t change (concept_framing_set); a different idea is a new concept. An archived concept takes no new creatives until restored (archived=false in the same call works). A creative already in another concept is refused (in_other_concept, naming its concept) unless move_from_other_concepts, and one whose angle differs from the concept’s is refused (angle_mismatch).
Returns: concept: id, name, brief, persona {id, name, deleted}, desire {id, outcome, problem, why}, awareness, angle, framing_locked, framing_proposal, naming_key, master_creative_id, creative_count, creative_ids (the first 9; creative_ids_truncated when there are more), archived, framing_missing (the framing fields still blank on a concept with creatives), joined (creatives that joined with the ones you added: the same copy on another platform, other sizes of a picture)
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
concept_id | string | yes | The concept (crtv_concept_…) to change. | |
name | string | no | New name. | |
brief | string | no | New brief; an empty string clears it. | |
angle | string | no | New persuasion angle from the creative taxonomy; an empty string clears it. | |
persona_id | string | no | Who it is for: a persona (persona_…) from list_personas. | |
desire_id | string | no | What they want: one of the persona’s desires (d_…) from list_personas or get_persona; an empty string clears it. | |
new_desire_outcome | string | no | Instead of desire_id, only when none of the persona’s desires fits: what they want, e.g. ‘get permits approved’. Added to the persona as a desire (one with the same words is reused), and the concept names it. | |
new_desire_problem | string | no | With new_desire_outcome: without what, e.g. ‘the back and forth’. | |
awareness | string | no | Awareness level: unaware, problem_aware, solution_aware, product_aware or most_aware. | |
hook | string | no | No longer accepted: a hook belongs to a version (creative), not the concept. | |
master_creative_id | string | no | Make this creative (ad_crtv_…) the master; an empty string clears the master. | |
add_creative_ids | array | no | Creatives (ad_crtv_…) that join the concept. | |
remove_creative_ids | array | no | Members (ad_crtv_…) that leave the concept; a master that leaves stops being master. | |
archived | boolean | no | True archives the concept, false restores it. Omit to leave it. | |
move_from_other_concepts | boolean | no | false | Move creatives that are already in another concept into this one. Only when the user agreed: they leave their current concept. |
allow_angle_mismatch | boolean | no | false | Add creatives whose TAGGED angle differs from the concept’s anyway. Only when the user says the tag is wrong; a declared angle is never overridden. |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.