---
title: "Terminate a tenant practitioner specialty with cascading support"
method: PUT
path: "/practitioners/tenant-practitioner-specialties/terminate"
tags: ["Practitioner"]
---

# Terminate a tenant practitioner specialty with cascading support

`PUT /practitioners/tenant-practitioner-specialties/terminate`

Terminates a tenant practitioner specialty and optionally cascades the termination to related specialties at the group, location, and network levels.

## Headers

- `tenant-id` string

## Request body

- PractitionerSpecialtyTerminationRequest
  - `tenantPractitionerSpecialtyId` string, required — The ID of the TenantPractitionerSpecialty to terminate (required)
  - `terminationDate` string, required — Termination effective date (YYYY-MM-DD)
  - `terminationReason` string — Termination reason
  - `terminationInformedDate` string — Date when termination was informed (YYYY-MM-DD)
  - `groupTerminations` GroupPractitionerSpecialtyTermination[] — Optional list of group practitioner specialty terminations to cascade to. Each entry handles cascading termination for a specific practitioner-group relationship.
    - `tenantGroupPractitionerId` string, required — The TenantGroupPractitioner ID for cascading termination
    - `tenantSpecialtyId` string — Optional tenant specialty ID for group-level specialty termination
    - `tenantGroupPractitionerSpecialtyId` string — Optional tenant group practitioner specialty ID for direct termination
    - `tenantGroupPractitionerNetworkId` string — Optional tenant group practitioner network ID for network specialty termination
    - `tenantGroupPractitionerLocationId` string — Optional tenant group practitioner location ID for location specialty termination
    - `tenantGroupLocationPractitionerNetworkId` string — Optional tenant group location practitioner network ID for location-network specialty termination
    - `tenantGroupPractitionerLocationSpecialtyId` string — Optional tenant group practitioner location specialty ID for location-network specialty termination

## Response `200`

Tenant practitioner specialty terminated successfully

## Other responses

- `400` — Bad request - Invalid input
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Tenant practitioner specialty not found
- `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/3d27e9019c7b/schema)