Renamed the featureId path parameter to entityId on plugin integration connection endpoints to align with the unified entity model used across the v2 API. This is a non-breaking change — the actual URL pattern is unchanged, only the parameter name in the spec was updated.

• Get plugin integration connection {featureId} → {entityId}
• Configure plugin integration connection {featureId} → {entityId}
• Delete plugin integration connection {featureId} → {entityId}

• Create note, Update note, Retrieve note Renamed note types to new canonical values: textNote, conversationNote, opportunityNote
• Legacy type values (simple, conversation, opportunity) are temporarily supported as aliases and will be removed on April 8, 2026

• List field values Added new endpoint to retrieve paginated list of allowed values for select-type and status fields (single select, multi select, status), with optional assignedEntityType filter for status fields
• Entity configuration endpoints now expose field values for single select, multi select, tags, and status fields

• Update team Team member management moved from dedicated endpoints to patch operations (addItems, removeItems, set, clear) on the update endpoint
• List team members Added new GET /teams/{id}/members endpoint returning a paginated list of team members
• Retrieve member, List members, Search members Added teams field to the member response

Example: Adding a member to a team

PATCH /v2/teams/{team_id}

{
  "data": {
    "patch": [
      {
        "op": "addItems",
        "path": "members",
        "value": [
          { "id": "550e8400-e29b-41d4-a716-446655440001" }
        ]
      }
    ]
  }
}

• Create note Added metadata.source property to specify the external system origin (system, recordId, url) when creating a note
• Retrieve note Notes now include metadata.source in responses
• List notes Added metadata[source][system] and metadata[source][recordId] query parameters for filtering by metadata source
• Search notes Added metadata.source.system and metadata.source.recordId search filters
• Deprecated the source field (id, origin, recordId, url) in favor of the new unified metadata.source system. The old source field will continue to work but should be migrated to metadata.source
• Update entity Field value metadata source properties renamed from externalSystemName/externalRecordId to source.system/source.recordId, and added source.url for linking to the external record
• Retrieve entity, List entities, Search entities Entity field value metadata now uses the unified source.system, source.recordId, and source.url properties in responses

• Search teams Added new endpoint to batch search teams by IDs, names, or handles (up to 100 each)
• Search members Added new endpoint to batch search members by IDs or emails, with filters for roles, disabled status, invitation status, and text query
• List teams Added handle query parameter for case-insensitive exact match filtering
• List teams The query parameter now also matches on team handle

Improved: Entities API

Configuration-driven filters

Entity configurations now include a filters array that describes which filter parameters are available for each entity type. Each filter entry provides:

• The exact query parameter name to use (e.g., owner[id], status[name])
• The field or relationship it applies to
• The expected value schema (type and format)
• Any additional OAuth scopes required

Use List entity configurations to discover available filters before calling List entities or Search entities.

New field value schemas with metadata

Added metadata-enriched variants for additional field types:

• HealthUpdateFieldValueWithMetadata
• ProgressFieldValueWithMetadata
• TimeframeFieldValueWithMetadata
• WorkProgressFieldValueWithMetadata

These follow the same pattern as existing *WithMetadata schemas, including metadata.source and metadata.isViewableOnly properties.

New: Plugin Integrations API is now publicly available in V2

Manage plugin integrations and their connections programmatically using the new Plugin Integrations API.

• List plugin integrations Retrieve all plugin integrations in the workspace
• Create plugin integration Register a new plugin integration
• Get plugin integration Retrieve details of a specific plugin integration
• Update plugin integration Update an existing plugin integration
• Delete plugin integration Remove a plugin integration
• List plugin integration connections Retrieve all connections for a plugin integration
• Get plugin integration connection Retrieve details of a specific connection
• Update plugin integration connection state Update the state of a connection
• Delete plugin integration connection Remove a plugin integration connection

New: Webhooks API is now publicly available in V2

You can now subscribe to real-time notifications for changes in your Productboard workspace using the Webhooks API V2.

• List webhook subscriptions Retrieve all webhook subscriptions for the workspace
• Create webhook subscription Create a new webhook subscription to receive notifications for specified event types
• Get webhook subscription Retrieve details of a specific webhook subscription
• Delete webhook subscription Permanently delete a webhook subscription

• List note configurations and Retrieve note configuration Updated FieldValues schema: replaced inline property with top-level data array and added links.next for fetching dynamic value sets
  • Renamed FieldInlineValues to FieldValueItem with properly typed id (UUID), name, and assignedEntityTypes fields