Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
adlyse-ads
list_ad_accountsget_platform_supportget_write_operationsget_ad_creation_capabilitiesget_ad_build_specupdate_ad_build_speclist_ad_plansget_ad_plan_publicationget_ad_planimport_ad_to_planimport_live_ad_to_planreplace_ad_creativescreate_ad_plan_variantsadd_ad_plan_variantsupdate_ad_plan_groupgroup_ad_plansget_ad_plan_groupfreeze_ad_plan_grouppublish_ad_plan_groupcreate_ad_plancreate_ad_edit_planupdate_ad_planattach_ad_plan_assetfill_ad_plan_slotsfreeze_ad_planpublish_ad_planresolve_ad_publish_steplist_campaignsget_performancelist_change_eventslist_adsget_ad_performancelist_creative_librarypause_creative_adsupdate_ad_group_statusupdate_ad_statusupdate_campaign_statusupdate_campaign_budgetlist_swipe_filesave_competitor_ad_to_swipe_filesave_creative_to_swipe_fileremix_from_swipe_filestart_creative_jobresize_creativemake_variants_of_winnerget_creative_jobestimate_creative_batchstart_creative_batchbatch_to_plan_groupget_creative_batchsnapshot_catalog_productsgenerate_ad_copylist_ad_copycreate_creative_conceptpropose_creative_conceptsaccept_creative_concept_proposalupdate_creative_conceptlist_creative_conceptslist_personasget_personacreate_personaupdate_personadelete_personasuggest_personasrequest_creative_reviewget_creative_reviewupdate_draft_creative_copydelete_draft_creativescancel_creative_jobsave_url_to_swipe_fileupdate_swipe_file_itemset_swipe_file_favoriteremove_from_swipe_fileget_creative_workget_creative_workspaceopen_creative_workspacesave_creative_revisionselect_creative_revisionwithdraw_creative_reviewchange_creative_workspace_lifecyclemanage_creative_conceptmanage_creative_sizeslist_creative_reviewslist_creative_commentsadd_creative_commentresolve_creative_commentretry_persona_creationresolve_creative_copy_anglebind_creative_workspace_conversationlist_creative_jobsget_creative_performance_detail
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-ads

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#

NameTypeRequiredDefaultDescription
concept_idstringyesThe concept (crtv_concept_…) to change.
namestringnoNew name.
briefstringnoNew brief; an empty string clears it.
anglestringnoNew persuasion angle from the creative taxonomy; an empty string clears it.
persona_idstringnoWho it is for: a persona (persona_…) from list_personas.
desire_idstringnoWhat they want: one of the persona’s desires (d_…) from list_personas or get_persona; an empty string clears it.
new_desire_outcomestringnoInstead 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_problemstringnoWith new_desire_outcome: without what, e.g. ‘the back and forth’.
awarenessstringnoAwareness level: unaware, problem_aware, solution_aware, product_aware or most_aware.
hookstringnoNo longer accepted: a hook belongs to a version (creative), not the concept.
master_creative_idstringnoMake this creative (ad_crtv_…) the master; an empty string clears the master.
add_creative_idsarraynoCreatives (ad_crtv_…) that join the concept.
remove_creative_idsarraynoMembers (ad_crtv_…) that leave the concept; a master that leaves stops being master.
archivedbooleannoTrue archives the concept, false restores it. Omit to leave it.
move_from_other_conceptsbooleannofalseMove creatives that are already in another concept into this one. Only when the user agreed: they leave their current concept.
allow_angle_mismatchbooleannofalseAdd 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.

Previousaccept_creative_concept_proposalNextlist_creative_concepts