---
title: "Permanently delete a practitioner specialty and dependents"
method: DELETE
path: "/practitioners/{practitionerId}/tenant-practitioner-specialties/{tpsId}"
tags: ["Practitioner"]
---

# Permanently delete a practitioner specialty and dependents

`DELETE /practitioners/{practitionerId}/tenant-practitioner-specialties/{tpsId}`

Permanently and irreversibly deletes the specified practitioner specialty record along with all dependent specialty records at the group-location and group-location-network levels, in a single atomic transaction; this cannot be undone. Use it only when a specialty record must be completely removed, for example when it was created in error — to end a specialty with a termination date instead (reversible, preserves history), use `PUT /practitioners/tenant-practitioner-specialties/terminate`. `{practitionerId}` is the `certifyPractitionerId`, and `{tpsId}` is the internal identifier for the `TenantPractitionerSpecialty` record, obtained from the specialty list returned by `GET /practitioners/{practitionerId}/specialties` or related queries. The specialty must not be the primary specialty (`isPrimary=true`); attempting to delete the primary specialty returns an error.

## Path parameters

- `practitionerId` string, required
- `tpsId` string, required

## Headers

- `tenant-id` string

## Response `200`

A confirmation payload for the deleted specialty and its dependent records: `{"message": "Specialty removed successfully", "tenantPractitionerSpecialtyId": "<id>"}`.

## Other responses

- `400` — Bad request — cannot remove primary specialty
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — TenantPractitionerSpecialty 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/563848e0ecc0/schema)