---
title: "Update plugin integration"
method: PATCH
path: "/plugin-integrations/{integrationId}"
tags: ["plugin-integrations"]
---

# Update plugin integration

`PATCH /plugin-integrations/{integrationId}`

Partially updates a plugin integration. Fields not included in the request preserve
their current value.

If the integration is `enabled` and `fields.action.url` is updated, Productboard
sends a new probe to verify the updated endpoint. No probe is sent when `disabled`.

**`action` is write-only**: never returned in responses.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- object
  - `data` object, required
    - `fields` PluginIntegrationUpdateFields, required — Domain attributes for partially updating a plugin integration. All fields are optional — fields not included preserve their current value. Note: `action.headers.authorization` is write-only and never returned in responses. If `action` is updated while the integration is `enabled`, a new probe is sent.
      - `integrationStatus` 'enabled' | 'disabled' — Controls whether the integration is active: - `enabled` — integration column is visible and the push button is active - `disabled` — integration column is hidden from the Features board
      - `name` string — Human-readable name shown as the column name on the Features board and in Productboard settings.
      - `initialState` PluginIntegrationInitialState — Configuration of the push button before an entity has been connected to the third-party system.
        - `label` string, required — Label shown on the push button in its initial (unconnected) state.
      - `action` Action — Configuration for the action endpoint Productboard calls when a user interacts with a push button (push, unlink, or dismiss).
        - `url` string, uri, required — HTTPS endpoint Productboard calls when a user clicks a push button. Requirements: - Must use `https` - TLS certificate must be valid and signed by a public authority - Must be publicly reachable (no `localhost`, private IPs, or internal addresses)
        - `version` 1, required — Version of the action payload format. Currently only `1` is supported.
        - `headers` ActionHeaders — Custom headers included in every outgoing request from Productboard to your action endpoint — both the creation probe and all action notifications.
          - `authorization` string — Raw value sent in the `Authorization` header of every outgoing request. This field is **write-only** and never returned in API responses. Supports any scheme: - `Basic aGVsbG86d29ybGQ=` - `Bearer <token>` - Any custom single-header auth scheme

## Response `200`

Plugin integration updated successfully

- object
  - `data` PluginIntegrationReference, required — Minimal reference to a plugin integration, returned in mutation responses.
    - `id` string, uuid, required — Unique identifier for this plugin integration.
    - `links` PluginIntegrationLinks, required — Links for this plugin integration resource.
      - `self` string, uri, required — URL to retrieve this plugin integration.
      - `connections` string, uri, required — URL to list all connections for this plugin integration.

## Other responses

- `400` — Bad Request - Invalid input format or malformed request
- `401` — Unauthorized - Missing or invalid authentication credentials
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - The requested resource does not exist or is not accessible
- `408` — Request Timeout - The server did not receive a complete request within the allowed time
- `422` — Unprocessable Entity - Validation failed (e.g., missing required fields, unknown fields)
- `429` — Too Many Requests - API rate limit exceeded, reduce request frequency and retry after the indicated time
- `500` — Internal Server Error - An unexpected error occurred on the server, please retry or contact support

---

[API](https://skmtc.dev/productboard/apis/notes.md) · [All operations](https://skmtc.dev/productboard/apis/notes/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productboard/notes/revisions/b4004749b60f/schema)