> ## Documentation Index > Fetch the complete documentation index at: https://docs.narrativebanking.com/llms.txt > Use this file to discover all available pages before exploring further. # v1.9.1 > Conversational onboarding, a goal-aware first Coach visit and a focused way to add business background for Growth. **2026-11-13** v1.9.1 ยท Major **v1.9.1 introduces conversational onboarding and a goal-aware first Coach visit, with a dedicated conversation for adding the business background Growth needs. Custom API integrations need report-access and request-handling updates.** ## Release overview Owners can answer onboarding questions in their own words, clarify an answer and revisit earlier questions. Short explanations show why the information is useful. The first Coach visit connects the owner's goal to available Money and Growth ideas and offers a practical place to start. Owners who skipped business background can add it in a focused conversation, with clear confirmation of what was saved and whether Growth preparation started. **Breaking changes:** Coach reports require the signed-in owner's authentication. Custom API clients must handle Chat request-validation responses and explicitly supply business background when updating Money Project inputs. See [Compatibility](#compatibility) for the required changes. **Deprecations:** None. ## Onboarding Onboarding pairs each question with relevant one-tap choices and free-text input. Owners can give more detail over several turns, correct earlier answers and use the question-progress header to see where they are. `Back`, `Skip` and `Keep as is` support reviewing answers and moving through optional questions. The bank connection is explained as read-only: Coach can use transactions to help explain spending and plan upcoming payments, but the connection cannot move money. Business and goal questions include a short reason for asking. ![An onboarding country question with UK, Ireland and Netherlands choices, a reason for asking and a free-text composer](https://mintcdn.com/narrative-b13c445c/YyAdZHXu5vTZ93w2/images/releases/v1.9.1/onboarding-country-input.png?fit=max\&auto=format\&n=YyAdZHXu5vTZ93w2\&q=85\&s=bae2d349a4f7de1c994267a701fae8b2) *Country choices and a free-text answer, with a short explanation of local context.* Sharing a website or business description remains optional. A saved website is kept when the optional description is skipped. When both are omitted, onboarding explains that financial help remains available and that business background can be added later to tailor Growth ideas. ## Coach The first Coach visit shows a goal-aware introduction and up to three available Money and Growth cards. When there are no cards to show, it explains the relevant next step, such as adding business background, asking about a cost or retrying a failed results load. Before the owner's first Coach message, `What can you do?` appears as the first starter and as a grey invitation in the composer. Selecting the starter or sending from the empty composer gives a short capability answer and a practical next step. Adding business background in its dedicated conversation preserves this invitation. The first-use introduction remains available on the day of the first visit; the capability invitation ends after the first Coach message. On subsequent days, Coach uses the daily briefing. ![A Daily Briefing with Money, Growth and Project highlights above the Coach composer](https://mintcdn.com/narrative-b13c445c/YyAdZHXu5vTZ93w2/images/releases/v1.9.1/coach-daily-briefing.png?fit=max\&auto=format\&n=YyAdZHXu5vTZ93w2\&q=85\&s=306f4b7110eac6d16cf17ab3a9e39c8c) *A Daily Briefing with Money, Growth and Project highlights above the composer.* Suggested follow-ups aim for two useful next questions where a truthful continuation is available. Answer suggestions wrap on narrow screens. Saved conversations load their retained messages when selected from conversation history. Money and Growth briefing cards use matching thumbnail sizes and consistent badge typography, with room for wrapped labels. Currency conversion cards identify the European Central Bank source, rate date and whether the rate is derived. They make clear that reference rates are not bank rates. A usable fallback rate is identified, and a saved card stops converting when its rate is more than seven calendar days old. Coach gives clear guidance on supported connections: direct point-of-sale connections are not available. Requests to conceal income are declined before offering a legitimate cash-book approach. ## Growth `Tell Coach about your business` opens a dedicated `Business background` conversation from Growth or the first Coach visit. It asks what the business sells or provides, accepts a short description or a website link and offers clarification when needed. Website checks respect the existing public-information setting. When a website describes a different business, the owner can choose which business to keep. The saved result shows the business name, website and description where available. `Done` closes the conversation, and `Skip for now` leaves the profile unchanged. After onboarding processing has succeeded, a save that makes the required Growth inputs ready can start preparation automatically. Growth shows the actual preparing or failed state and offers `Try again` when retry is available. Saving background does not enable public information or guarantee that ideas are ready. ## Money Saved Money Projects support skipping and undoing a skipped step, adopting a proposed version together with its summary and dismissing a proposal. These actions keep the saved work and its displayed state aligned. ## Compatibility v1.9.1 builds on v1.9.0. Its release type is `Major` because the API changes below require some existing integrations to be updated, although the version number remains `v1.9.1`. ### Coach report access Custom integrations retrieving Coach report content, preview images, PDFs, metadata or report context must send `Authorization: Bearer ` for the user who owns the report. Access is limited to that user within their tenant; a report URL alone does not grant access. Fetch the report with that authenticated request, check for a successful response, then display or save the returned content. Direct image, frame or download links that cannot send the bearer header need an authenticated retrieval step. Do not put access tokens in report URLs. The hosted Narrative app handles authenticated report retrieval. Partners using its report controls do not need a separate client-code change for this requirement. ### Custom API clients Chat session creation, binding updates and message submission return HTTP `422` for request-validation failures. Handle the validation details as input errors and keep support for other documented error responses, including HTTP `400` for too many attachments. Money Project input updates require an explicit `background` field. Send the saved description to keep it, a non-empty replacement of up to 2,000 characters to change it, or `null` to clear it. Omitting the field is invalid; do not clear an owner's saved description just to satisfy validation. Project responses can include the `skipped` step state and `completed` lifecycle. Custom response validation must accept these values. Chat streams can also include a `turn_state` control carrying the current turn's state; handle it separately from answer text. The hosted app handles these request and response contracts. ### Earlier upgrades Partners upgrading from v1.8 should also follow the [v1.9.0 compatibility guidance](https://docs.narrativebanking.com/releases/v1.9.0.md#compatibility), including its sign-in and partner-integration changes. Public-information preferences continue to apply to website checks and Growth preparation. ## Support Read the updated [onboarding guide](https://docs.narrativebanking.com/sdk/onboarding.md), [Coach guide](https://docs.narrativebanking.com/sdk/api-coach.md), [Growth guide](https://docs.narrativebanking.com/sdk/api-growth.md), [Money guide](https://docs.narrativebanking.com/sdk/api-money.md) and [FAQ](https://docs.narrativebanking.com/sdk/faq.md). Questions about this release or integration: [support@narrativebanking.com](mailto:support@narrativebanking.com) SDK documentation: [docs.narrativebanking.com](https://docs.narrativebanking.com/index.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.