---
title: "List plugin integrations"
method: GET
path: "/plugin-integrations"
tags: ["plugin-integrations"]
---

# List plugin integrations

`GET /plugin-integrations`

Returns all plugin integrations for the workspace.

Paginated using cursor-based pagination. Follow `links.next` to fetch the next page.
When `links.next` is `null`, you have reached the last page.

**OAuth2 isolation**: OAuth2 access tokens only see integrations created by the same
OAuth2 application. Public API access tokens see all workspace integrations.

## Query parameters

- `pageCursor` string

## Response `200`

A paginated list of plugin integrations

- object
  - `data` PluginIntegration[], required
    - `id` string, uuid, required — Unique identifier for this plugin integration.
    - `type` 'pluginIntegration', required — Resource type identifier.
    - `createdAt` string, date-time, required — ISO 8601 timestamp when the integration was created.
    - `fields` PluginIntegrationResponseFields, required — Domain attributes returned in plugin integration responses. Note: `action` is intentionally absent — it contains a write-only authorization secret that is never returned by the API.
      - `type` string, required — Type identifier for the integration. Use your reversed domain name as a prefix to ensure global uniqueness (e.g., `com.example.myservice`). Integrations of the same type share the same icon and settings grouping in Productboard.
      - `name` string, required — Human-readable name shown as the column name on the Features board and in Productboard settings.
      - `integrationStatus` 'enabled' | 'disabled', required — 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
      - `initialState` PluginIntegrationInitialState, required — 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.
    - `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.
  - `links` ListLinks, required
    - `next` string, nullable, required

## Other responses

- `400` — Bad Request - Invalid input format or malformed request
- `401` — Unauthorized - Missing or invalid authentication credentials
- `403` — Forbidden - Insufficient permissions
- `408` — Request Timeout - The server did not receive a complete request within the allowed time
- `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)