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

# Read pending configuration

`GET /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

## Response `200`

Pending configuration

- object
  - `data` union
    - 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[]
              - …
            - object
              - …
      - `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
    - PluginInstallation
      - `id` string, uuid, required
      - `state` 'setup_required' | 'ready' | 'completed' | 'cancelled' | 'expired' | 'removed', required
      - `source` object, required
        - `kind` string, required
        - `id` integer, required
        - `revision` string, required
        - `choice_id` string, required
        - `device_id` integer
      - `plugin_setting_id` integer, nullable, required
      - `expires_at` string, date_time, required

---

[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)