---
title: "Correct the specialty on a group facility specialty record"
method: PATCH
path: "/facilities/tenant-group-facility-specialties/specialty"
tags: ["Facility"]
---

# Correct the specialty on a group facility specialty record

`PATCH /facilities/tenant-group-facility-specialties/specialty`

Replaces the tenant_specialty_id on a TenantGroupFacilitySpecialty record (Level 3) in data-correction mode. Use this for data-correction scenarios where a group-level facility specialty association is incorrect and the correction must propagate to its child records — cascades to the group-facility-location and group-facility-network specialty records (Levels 4, 5) that are children of this association via FK chain. For correcting only a facility-level (non-group) record, use PATCH /facilities/tenant-facility-specialties/specialty instead. Does not trigger termination events. Returns the raw updated Level-3 record (id, tenantSpecialtyId, data) as an untyped JSON object.

## Headers

- `tenant-id` string

## Request body

- CorrectGroupFacilitySpecialtyRequest
  - `tenantGroupFacilitySpecialtyId` string, required — ID of the existing TenantGroupFacilitySpecialty record to correct
  - `newTenantSpecialtyId` string, required — ID of the new TenantSpecialty to replace the current one
  - `changeReason` string — Optional human-readable reason for the change, captured for audit trail.

## Response `200`

Specialty corrected successfully

- object

## Other responses

- `400` — Bad request - Invalid input
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Tenant group facility specialty not found
- `409` — Conflict - Group facility already has this specialty
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)