{"version":"2.1.323","anchor":"headless-apply-flag-settings-wrapped-in-error-handling-get","canonical_anchor":"headless-apply-flag-settings-wrapped-in-error-handling-get","heading":"SDK apps get clearer settings errors, more permission details and advisorModel","tier":"use","area":"SDK","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.323\/e\/headless-apply-flag-settings-wrapped-in-error-handling-get","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.323","markdown":"### SDK apps get clearer settings errors, more permission details and `advisorModel`\n\nSDK apps now get an error when applying flag settings fails, can read permission details, and can set `advisorModel`\n\n**What**\n\nApps that drive Claude Code through the Agent SDK send requests to change and read its settings.\n\n- `apply_flag_settings`: if the request fails, Claude Code now logs it and replies with `apply_flag_settings failed`. Before, some failures were caught only on a delayed path.\n\n- `advisorModel`: flag settings now apply this key, which picks the model that answers when Claude asks the advisor tool.\n\n- `get_settings`: the reply now includes details about tool permissions.\n\n- `get_settings`: when `blockFileToolReadsOutsideWorkingDirectories` is true, it now waits for the read limits to be set up before replying.\n\n**Why**\n\nSDK apps get a clear error instead of silence when applying settings fails. They can also choose the advisor model and see the current permission state.\n\n- Area: SDK\n- Names: `advisorModel`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 3\/5\n- Scope: individual\n- Heads-up: no"}