Public API Changelog
This document details the release notes for the Prewave Public API for the first quarter of 2026. This quarter focused on transitioning to Supplier Management v2, introducing Actions and User Management APIs, and preparing for the launch of Feed v2.
🚀 Q1 Overview
January: Launched Supplier Management v2 and Identifier Management. Announced deprecations for legacy endpoints with a sunset date of December 31, 2026.
February: Released User and Role Management, Supplier Connection Contacts, and the Actions API.
March: Announced Feed v2 (
GET /public/v2/feed), which will be publicly available on March 19, 2026.
📦 Supplier Management API v2
Base path: /public/v2/suppliers/sites
The legacy Sites-Upsert flow (v1) was replaced with a RESTful approach to reduce integration complexity and payload sizes.
Feature | Legacy (v1) | New (v2) |
Logic | Complex batch with FULL/DELTA load semantics | Standard REST patterns (POST, GET, DELETE) |
Feedback | Asynchronous status polling | Synchronous responses with clear HTTP codes |
Payload | Large, nested payloads | 60-80% smaller payloads with essential fields |
⏳ Tracking Creation Status
New suppliers enter a pending state for enrichment and matching, which typically takes a few hours.
Track Status: Use
GET /public/v2/suppliers/sites/pending?uuid={UUID}.Completion: Once processed, the supplier moves from
/pendingto the main site list.
🔗 Supplier Identifier Management
Identifiers link Prewave suppliers to your external systems (e.g., SAP, Coupa, D&B).
Find by Identifier:
GET /public/v2/suppliers/sites/find-by-identifierresolves external IDs to Prewave details.Add Identifier:
POST /public/v2/suppliers/sites/identifiers?prewaveId={ID}.Deactivate:
DELETE /public/v2/suppliers/sitesallows deactivating suppliers using your own system IDs.
✅ New APIs (February 2026)
User and Role Management
Manage users and their permissions within your scope.
Users: List, create, and update user profiles via
/public/v1/users.Roles: View available roles and manage user assignments via
/public/v1/users/{userId}/roles.
Supplier Connection Contacts
Manage contact persons for your suppliers.
Endpoints: List, get, create, or delete contacts at
/public/v2/suppliers/connection-contacts.
Actions API
Work with action records, types, and statuses.
Endpoints: List and retrieve detailed action information at
/public/v1/actions.
⚠️ Deprecations & Removals
Migration Deadline: December 31, 2026.
Deprecated endpoints now include a Sunset HTTP header to indicate removal dates. Notable removals include:
Legacy authentication (
POST /public/v1/auth) — Use API Tokens instead.Legacy target connection/disconnection endpoints — Use Supplier Management v2.
Legacy batch systems — Use v2 Pending tracking.
💬 Support
Email: [email protected]
Knowledge Base: help.prewave.com
CSM: Contact your Customer Success Manager