latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Group

Batch add and update group specialties

Adds new specialty associations and/or updates existing specialty associations for a group in a single request. New entries create group–specialty records; update entries modify existing associations (effective/termination dates, specialty linkage). Use this endpoint for bulk specialty management — for single-specialty additions use POST /groups/{id}/specialties, and for date-only updates to a single specialty use PUT /groups/{id}/specialties. Permission note: if any update entry includes a non-blank newTenantSpecialtyId (reassigning the specialty), the caller must also hold the group:correct:specialty permission — such a request without that permission returns 403. Pure additions or date/isPrimary-only updates only require the standard group:update permission.

patch/groups/{id}/specialties

Path parameters

idstring required

Group ID (certifyGroupId)

Headers

tenant-idstring

Request body

changeReasonstring

Optional reason for change, applied to all operations

Example request

{
  "updates": [
    {
      "tenantGroupSpecialtyId": "tgs_abc123",
      "newTenantSpecialtyId": "ts_xyz789",
      "effectiveDate": "2026-01-15"
    }
  ],
  "additions": [
    {
      "tenantSpecialtyId": "ts_cardiology_001",
      "effectiveDate": "2026-01-01"
    }
  ],
  "changeReason": "Correcting specialty mappings per annual review"
}

Response

Group specialties successfully managed

updatedSpecialtiesobject[]

Results from updated specialty records

addedSpecialtiesobject[]

Results from newly added specialty associations