v2 - 2026-02-24 - Teams API

by ReadMe GitHub Action

New: Teams API is now publicly available

You can now manage workspace teams programmatically through the Teams API.

Breaking change: Unified member identifiers

We've migrated all member-related fields across the API to a new, more reliable set of member identifiers. The previous UUIDs were based on an internal scheme that wasn't designed for long-term external use. The new membership UUIDs are stable, consistent across all endpoints, and built to stay future-proof as the platform evolves.

What changed:

  • Entities API - The owner field and custom member fields now return and accept membership UUIDs instead of legacy identifiers
  • Notes API - The owner and createdBy fields now return and accept membership UUIDs instead of legacy identifiers
  • Analytics API - The member id in query parameter now uses membership UUIDs for member-based filtering

If your integration reads or writes member-related fields, you will need to update your code to use the new membership UUIDs. You can look up the correct UUID for any member using the new Members API (see below).

New: Members API is now publicly available

You can now use the Members API to list and look up workspace members, including searching by email address. This makes it straightforward to find the correct membership UUID for any user in your workspace.

This is especially useful for automations that assign owners or set member fields: search for a member by email, get their UUID, and use it directly in your entity or note updates.

  • Search notes Added endpoint for filtered search over notes with support for relationship-based filtering by customers and links
  • List relationships Added type and target[type] query parameters to filter relationships by type and target entity type
  • Renamed endpoint summaries for consistency: "Retrieve note" → "Get note", "Retrieve relationships" → "List relationships", "Delete note relationship" → "Delete relationship"

v1 - 2026-02-18

by ReadMe GitHub Action
  • Company Fields Documentation: Clarified that company custom fields can be assigned to other item types (features, components, etc.) through the Productboard UI. Updated documentation to explain that changes to field properties propagate across all item types, and deletion removes the field from all item types permanently.

v1 - 2026-02-17

by ReadMe GitHub Action
  • Company Custom Field Values: The value field for number custom fields on PUT /companies/{companyId}/custom-fields/{customFieldId}/value now enforces a range of -9999999999.99 to 9999999999.99. Decimal values are rounded to 2 decimal points.

v1 - 2025-12-03

by ReadMe GitHub Action
  • Company Custom Field Values: The type field in the request body for PUT /companies/{companyId}/custom-fields/{customFieldId}/value must now match the company custom field definition type. If the provided type does not match, a 400 Bad Request error is returned with error code validation.request.body.schema.typeMismatch.

v1 - 2025-10-15

by ReadMe GitHub Action
  • Add new field types: date, single select and multi select, to the feedback form configurations.