latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Facility

Batch add and update facility specialties

Applies a batch of specialty updates and additions to a facility in a single request. Use this when you need to modify multiple specialty associations at once; for a single new specialty, use POST /facilities/{id}/specialties instead. Updates modify existing TenantFacilitySpecialty records (specialty FK, effective date, isPrimary) and are applied as one all-or-nothing batch — if that batch call fails, the entire request fails, with no partial-success path for updates. Additions create new specialty associations at the facility level and are processed independently — a failure on one addition is captured in the response's errors array and does not stop or fail the other additions.

patch/facilities/{id}/specialties

Path parameters

idstring required

Facility ID

Headers

tenant-idstring

Request body

changeReasonstring

Optional reason for change, applied to all operations

Example request

{
  "updates": [
    {
      "tenantFacilitySpecialtyId": "tfs_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

Specialties managed successfully

updatedSpecialtiesobject[]

Results from updated specialty records