{"version":"2.1.299","anchor":"apply-flag-settings-model-list-now-an-object-with-formodels","canonical_anchor":"apply-flag-settings-model-list-now-an-object-with-formodels","heading":"A model list sent by a controlling program now needs a different shape","tier":"notice","area":"SDK","scope":"individual","heads_up":true,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.299\/e\/apply-flag-settings-model-list-now-an-object-with-formodels","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.299","markdown":"### A model list sent by a controlling program now needs a different shape\n\nA model setting sent through `apply_flag_settings` must now be an object with \"for\" and \"models\" instead of a plain list of model IDs\n\n**Unclear.** Which setting under `apply_flag_settings` takes this value is not named.\n\n**What**\n\nA program that drives Claude Code can change session settings through `apply_flag_settings`. One of those settings takes a list of models. It used to accept a plain list of one to three model IDs, or null. It now has to be null or an object with exactly two keys, \"for\" and \"models\". Any other shape produces a warning.\n\n**Why**\n\nPrograms that send the old plain list will now get a warning and need to switch to the new shape.\n\n- Area: SDK\n- Names: `apply_flag_settings`\n- Tier: You'll notice\n- Useful: 3\/5\n- Signal: 3\/5\n- Scope: individual\n- Heads-up: yes"}