---
title: "Save pending configuration"
method: PATCH
path: "/api/plugin_installations/{plugin_installation_id}/configuration"
tags: ["Installations"]
---

# Save pending configuration

`PATCH /api/plugin_installations/{plugin_installation_id}/configuration`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/plugin_installations/{plugin_installation_id}/configuration`
- Auth: HTTP bearer

## Request body

- ConfigurationWrite
  - `revision` string, required
  - `changes` ConfigurationChange[], required
    - `op` 'set' | 'unset' | 'clear_secret', required
    - `path` string, required
    - `value` unknown

## Response `200`

Updated pending configuration

- object
  - `data` PluginConfiguration
    - `schema_version` 1, required
    - `revision` string, required
    - `required_capabilities` string[], required
    - `sections` object[], required
      - `id` string, required
      - `title` string, required
      - `fields` ConfigurationField[], required
        - `path` string, required
        - `type` string, required
        - `label` string, required
        - `help` string
        - `required` boolean, required
        - `read_only` boolean, required
        - `nullable` boolean, required
        - `constraints` object, required
        - `choices` union
          - object[]
            - `label` string, required
            - `value` unknown, required
          - object
            - `resolver_id` string, required
            - `depends_on` string[], required
            - `searchable` boolean, required
            - `paginated` boolean, required
    - `values` object, required: Only declared nonsecret values. Secret values are never returned.
    - `secrets` object, required
    - `connections` object[], required
    - `actions` object[], required
    - `readiness` object, required
      - `ready` boolean, required
      - `blocking_paths` string[], required
      - `reason` string, nullable
    - `sync` PluginSync, required
      - `source_kinds` string[], required
      - `upload_allowed` boolean, required
      - `reason` string, nullable
      - `action_id` string, nullable

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)