> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/adapters/configure/update-configuration/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Update adapter configuration fromItential Platform

> How to use the iapUpdateAdapterConfiguration task in anItential Platform workflow to update adapter configuration files without making changes directly on the file system.

The `iapUpdateAdapterConfiguration` method lets you update adapter configuration from withinItential Platform rather than editing files directly on the server. It can update endpoint configuration files (such as `action.json` and schema files), mock data files, and `package.json`.

Do not use `iapUpdateAdapterConfiguration` in the Itential SaaS platform. Changes made to the file system are lost the next timeItential Platform restarts, because the environment is rebuilt from an image that does not include those changes.

## Run the task in a workflow

InItential Platform, navigate to **Automation Studio** and open **Workflow Builder**. Find the adapter you want to update, then add the `iapUpdateAdapterConfiguration` task to your workflow.

## Input parameters

| Input        | Required | Description                                                                                                   |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------- |
| `configFile` | Yes      | The name of the file to update.                                                                               |
| `changes`    | Yes      | An object containing the changes to apply, formatted to match the structure of the target configuration file. |
| `entity`     | No       | The entity the file belongs to — required when updating an action, schema, or mock data file.                 |
| `type`       | No       | The type of entity file to update: `action`, `schema`, or `mock`.                                             |
| `action`     | No       | The action the file is associated with — required when updating an action or mock data file.                  |
| `callback`   | —        | Returns the result of the call.                                                                               |

When `type` is `mock`, an additional `replace` input controls whether the existing mock data is replaced by the contents of `changes` (`true`) or merged with it (`false`).

## Example: updating a mock data file

Set `configFile` to the name of the mock data file you want to update and `changes` to the new data. Set `type` to `mock` and `replace` to `true` to overwrite the existing content rather than merging it. Set `entity` and `action` to identify which entity and action the mock data file belongs to.

The task writes the changes to the file in the adapter's directory, so the updated mock data is available immediately without a restart or any direct file system access.

> How to use the iapUpdateAdapterConfiguration task in anItential Platform workflow to update adapter configuration files without making changes directly on the file system.