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
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