v1

latestOpenAPI 3.1.1Productboard Proprietary2026-07-2453178243.2 KB
plugin-integration-connections

List plugin integration connections

Returns all connections for a plugin integration, excluding those in the initial state. The initial state is the default — it means no connection has been established for that entity yet.

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

get/plugin-integrations/{integrationId}/connections

Path parameters

integrationIdstring uuid required
Example:00000000-0000-0000-0000-000000000001

UUID of the plugin integration.

Query parameters

pageCursorstring

Cursor for pagination. Use the value from links.next to fetch the next page.

state[]ConnectionStateName[]

Filter by connection state. Can be specified multiple times to match any of the given states.

Response

A paginated list of plugin integration connections

Example response

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000002",
      "type": "pluginIntegrationConnection",
      "fields": {
        "connection": {
          "label": "Done",
          "hoverLabel": "Issue 123",
          "tooltip": "Issue 123 - Implement XYZ",
          "color": "green",
          "targetUrl": "https://example.com/issues/123"
        }
      },
      "links": {
        "self": "https://api.productboard.com/v2/plugin-integrations/00000000-0000-0000-0000-000000000001/connections/00000000-0000-0000-0000-000000000002"
      }
    }
  ]
}