> For the complete documentation index, see [llms.txt](https://docs.appfarm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfarm.io/changelog/releases/166.md).

# 166

Appfarm 166 makes Flow endpoints answer failed runs with an error status, runs private Flow Actions only from their own Flow, and shows the request and the response in Flow DevTools.

| Channel  | Date              |
| -------- | ----------------- |
| Early    | November 2, 2026  |
| Standard | November 9, 2026  |
| Stable   | November 16, 2026 |

{% hint style="info" %}
**Check before your Solution upgrades**

* **Failed Flow endpoint runs answer with an error status.** A failed run used to answer `200 OK` with the error in the body. It now answers with the **Response code** of the [Throw Exception](https://docs.appfarm.io/library/action-nodes/throw-exception.md) that ended it, or `500`. Check callers that read errors from a `200` body. If one can't be changed in time, ask Appfarm support to keep the old behavior for your Solution, and ask early, because the change isn't instant.
* **Private Actions only run from their own Flow.** A Flow Action with **Private Action** is refused when [Run Flow](https://docs.appfarm.io/library/action-nodes/run-flow.md) starts it from an app or another Flow, and from a schedule or MCP. Use **Run Action** inside its own Flow.
* **A header API token wins over `?token=`.** A caller that adds its own `Authorization` header and passes the Appfarm key as `?token=` will fail.
* **HTML in Map tooltips and popups shows as text.** Turn on **Markdown** for formatting in a popup.
  {% endhint %}

## New and improved

### Flows

* **Failed endpoint runs answer with an error status.** A [Flow endpoint](https://docs.appfarm.io/reference/flows/api-endpoints.md) run that fails answers with the error's status instead of `200 OK`: the **Response code** set on the [Throw Exception](https://docs.appfarm.io/library/action-nodes/throw-exception.md) that ended it, or `500 Internal Server Error`. An unhandled timeout still answers `504`. A custom response body and headers are only sent when the run succeeds. (DEV-3227)
* **Response code on Throw Exception.** In Flows and Services, Throw Exception has a **Response code** setting, `500 Internal Server Error` by default. **Custom Code** is renamed **Exception code**. (DEV-3331)
* **Private Actions only run from their own Flow.** A Flow Action with **Private Action** is refused when started from an app or another Flow with [Run Flow](https://docs.appfarm.io/library/action-nodes/run-flow.md), from a [schedule](https://docs.appfarm.io/reference/flows/schedules.md) or from an [MCP server](https://docs.appfarm.io/reference/flows/mcp-servers.md). Run Action inside the same Flow and Flow DevTools still run it. Create no longer offers a schedule on a private Action. (DEV-3360)
* **Cached endpoint responses are kept per caller and request.** With **Cache response data** on, a cached response is reused only for the same caller, path parameters, query and mapped headers.
* **A Flows page you can search.** The [Flows](https://docs.appfarm.io/reference/flows.md) page has **Grid view** and **List view**. The list sorts by name, Action counts, creator and created date, and shows **API endpoints** and **MCP tools** columns when a Flow uses them. Search matches every word in names and descriptions. Your view and sort are remembered. (DEV-3344)
* **Flow Actions permissions** says it lists Actions with a role picked under **Restrict permissions**, and says so when none do. (DEV-2011)

### Flow DevTools

* **Call preview.** Above an endpoint's inputs, [Flow DevTools](https://docs.appfarm.io/reference/appfarm-client/developer-tools-for-flows.md) shows the request the inputs make, with unfilled path parameters marked and a button to copy the URL. A date input shows the UTC value it sends and can be cleared. (DEV-2597)
* **Required inputs.** Run an endpoint with a required query, header or body input left empty to see the `400` a caller would get. A required path parameter still blocks the run, with a note saying why. (DEV-3307)
* **Run information.** The run status opens a popover with **Ran as**, **Trigger**, **Started**, **Finished** and **Allowed roles**, and a link to **Manage permissions in Create**. (DEV-2005)
* **Endpoint response.** A failed or refused endpoint run shows the response the caller got, with status and body. (DEV-3226)
* **Full data view reads whole data sources,** up to 10,000 rows and 4 MB per run, instead of the first 25 rows. Rows can be searched and filtered by column. (DEV-2345, DEV-3332)
* **Data panel open by default.** Resource files fold into one **Resource files** group that lists only the files the Action uses. (DEV-3299, DEV-3244)
* **API keys see their own Flows.** An API key limited to certain Flows lists only those Flows. (DEV-2316)

### Security and API keys

* **API keys are held to their approved Flows on MCP.** An API key limited to certain Flows gets `403` on [MCP servers](https://docs.appfarm.io/reference/flows/mcp-servers.md) outside that list, as on endpoints. Manage the list on the key in [Service accounts](https://docs.appfarm.io/reference/security/service-accounts.md).
* **A header API token wins over `?token=`.** When a request sends a token in a header (`X-AF-API-Token` or `Authorization: Bearer`) and as `?token=`, the header is used. This applies to Services, GraphQL and MCP.

### Apps

* **Typography on Rich Text.** [Rich Text](https://docs.appfarm.io/library/ui-components/rich-text.md) has the **Typography** style section from Rich Text Edit. Existing components look the same. Added in 166.0.16.
* **Map tooltips show plain text.** The marker **Tooltip**, and **Popup text** with **Markdown** off, show text as written, so HTML tags appear as text in the [Map](https://docs.appfarm.io/library/ui-components/map.md).
* **A clearer crash screen.** An app that stops unexpectedly shows **This app stopped unexpectedly** with **Reload app**. A coded component that crashes shows **Coded component failed** in its own place, and the rest of the app keeps working. (DEV-2660, DEV-3304)
* **Send Client State is removed** from [Developer tools for Apps](https://docs.appfarm.io/reference/appfarm-client/developer-tools-for-apps.md), and the node is no longer offered. Apps that still contain it keep running; it logs a warning and does nothing.

### Appfarm Create

* **Secrets where you use them.** The value menu's **Secret** opens a searchable list of [secrets](https://docs.appfarm.io/reference/security/secrets.md), and secret fields such as mail keys, custom auth providers and [Update Secret](https://docs.appfarm.io/library/action-nodes/update-secret.md) use the same list. **Create secret** makes a new secret and fills it in. (PRO-378, PRO-379)
* **Shorter labels.** Settings on Action nodes, UI components and the data model have shorter sentence-case labels with clearer descriptions, and checkboxes drop "Enable", for example **Markdown**, **Status code** and **Replace existing**.
* **Crash screen.** **Create stopped unexpectedly** offers **Reload Create**, **Contact support** and **Details for support**. A panel that crashes leaves the rest of Create working. (DEV-2662)
* **Menus.** Filter menus keep their search in view while you scroll, and the References panel keeps its Apps, Services and Flows headings in view. (DEV-1962)
* **Uniqueness errors name the property** that must be unique. (DEV-2931)

### Appfarm AI

* **A code agent.** [Appfarm AI](https://docs.appfarm.io/reference/appfarm-ai/build.md) hands functions, Run Code, coded components and email or document HTML to a code agent on Claude Opus 5.5, at the same credit rate as the other build agents. (DEV-3325)
* **Code edits in parts.** Long code is changed in parts instead of rewritten, and each step shows the lines added and removed. (DEV-3317, DEV-3340)
* **Continue from the function editor.** **Continue in Appfarm AI chat** saves the function, closes the editor and starts a message in the Appfarm AI sidebar. The editor's own AI panel is gone. (DEV-3342)
* **Builds more.** Appfarm AI can add Switch, Push Notification, Manage Flow, Request Permission, Install App, Print Dialog and Calendar Event nodes, App Bar and Speed Dial components, conditional styles, reference data sources, and app settings such as Open Graph and PWA. (DEV-3311, DEV-3312, DEV-3313, DEV-3314, DEV-3315, DEV-3316)
* **Role permissions stay with you.** Appfarm AI no longer changes role permissions. It tells you which roles need which access. (DEV-3326)

### Agent action node (by request)

The [Agent action node](https://docs.appfarm.io/library/action-nodes/agent.md) is turned on per Solution. Ask Appfarm to turn it on for yours.

* **One Tools list.** Each tool has a **Type**: **Data source**, **File data source**, **Action param**, **Action variable**, **Action** or **Flow**. Existing agents are converted and keep their tool names. (DEV-3305)
* The node's label shows the provider when it isn't Default. (DEV-3274)

## Fixes

* An app with a Function value that had no function never finished loading. It now stops with a message on the load screen that names the app, the Action and the node to fix. (DEV-3297)
* In Flows, a function property that read another function property on the same object came out empty. Function properties that depend on each other in a circle now fail with a message naming them. Fixed in 166.0.15. (DEV-3497)
* In a shareable component, a Container iterating a param bound to a data source's All showed every row's value joined together. (DEV-3335)
* The reference finder opened an Action's data source references in the wrong place. (DEV-2317, DEV-3321)
* When the server refused a change, the rollback toast didn't say why. (DEV-3355)
* Disabled Action nodes, and nodes that don't run, showed validation error icons.
* Persist, Set Selection, Import Data and Generate Document labels showed raw values such as "csv".
* Create said "Workflow" in a few places instead of Flow.
* Appfarm AI stopped a build on a badly formed tool call. It now retries, and stops only after three in a row. (DEV-3308)
* Reference Action params that Appfarm AI added to apps had no Object ID content. Existing ones are repaired when the app loads. (DEV-3294)
* Agent action node: newer Anthropic models that need reasoning failed every run, OpenAI reasoning models failed on a custom provider, and a rejected own OpenRouter key gave no reason. (DEV-3328, DEV-3330, DEV-3329)

***

Covers 166 up to 166.0.17.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appfarm.io/changelog/releases/166.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
