Merge updated data into a group by ID

PUT 
/groups/:id

Merges the supplied fields into an existing group identified by its certifyGroupId — an UPSERT_DATA merge, not a full replace; omitted fields are preserved on the existing record rather than cleared. Updatable fields include the group's core attributes and tax information; taxInfo.billingTin, taxInfo.billingNpi, and email are validated and return 400 if malformed. Use this endpoint for non-legacy group updates — for groups sourced from an external system and identified by source type and crosswalk ID, use the deprecated PUT /groups/{sourceType}/{crosswalkId} instead. Every call publishes an audit event, even when the merged data is identical to the existing record (no database row update occurs in that case, but the audit event is still emitted).

Request

Responses

200

Group successfully updated

400

Invalid request body — taxInfo.billingTin or taxInfo.billingNpi failed format validation

401

Unauthorized - Authentication required

403

Forbidden - Insufficient permissions

404

Group not found

500

Internal server error during request processing (e.g., network timeout, etc.)