Public API Changelog
This document contains the changelog and release notes for the Prewave Public API for February 2026. This month, we released new capabilities for user management, supplier relationship management, and workflow automation.
🚀 Key Updates at a Glance
The February release introduces four major API components to help you manage your public network and workflows:
Users API: List, retrieve, invite, and update users.
Users – Roles API: Discover and manage role assignments per user.
Supplier Connection Contacts API: Manage contact persons for your suppliers.
Actions API: Manage tasks and work items for integration with your internal workflows.
👤 Users API
Base path: /public/v1/users
Manage user profiles within your customer scope, including inviting new team members and updating existing details.
Method | Endpoint | Description |
|
| List users (supports filtering by |
|
| Retrieve a detailed user profile |
|
| Invite or create a new user |
|
| Update user details (partial update) |
Required Permissions:
ACCESS_PUBLIC_USERS(read);MANAGE_PUBLIC_USERS(create/update).
🔐 Users – Roles API
Base path: /public/v1/users (roles sub-resources)
Identify assignable roles within your organization and control user access levels.
List Available Roles:
GET /public/v1/users/roles/available.View User Roles:
GET /public/v1/users/{userId}/roles.Assign Roles:
POST /public/v1/users/{userId}/roles(accepts a list of role names).Remove Roles:
DELETE /public/v1/users/{userId}/roles/{roleName}.
📇 Supplier Connection Contacts API
Base path: /public/v2/suppliers/connection-contacts
Manage contact persons for your suppliers using Prewave IDs or your own internal identifiers (e.g., SAP Vendor IDs).
Identifying Suppliers
To resolve a supplier uniquely, you must provide exactly one of the following combinations:
prewaveIdsupplierId+sourcecustomerId+sourceownId+source
[!CAUTION]
If your criteria match more than one supplier, the API will return a 400 Bad Request.
✅ Actions API
Base path: /public/v1/actions
Integrate Prewave tasks (actions) into your own workflow tools. This API supports extensive filtering for compliance reviews and operational activities.
Endpoints: List all actions, retrieve full details of a specific action, and discover valid action types and statuses.
Filtering Options: Filter by
typeIds,statusIds,targetIds,assigneeIds, or date ranges (dueDate,createdAt,updatedAt).Required Permission:
ACCESS_PUBLIC_ACTIONS.
🔧 Improvements & Fixes
Bulk-fetch Fix:
POST /public/v1/target/targets/bulk-fetchnow correctly handlesnullvalues in the request payload without throwing exceptions.Documentation: Improved OpenAPI descriptions and examples for the Public User API.
⚠️ Deprecations & Removals
Deprecations: No new deprecations this month. The legacy supplier and sites-upsert endpoints are still scheduled for sunset on December 31, 2026.
Removals: No endpoints were removed in February 2026.
💬 Support
Need help with these updates?
Support Email: [email protected]
Knowledge Base: help.prewave.com
CSM: Contact your Customer Success Manager directly