Sign in
latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Terminate a practitioner specialty with optional cascade

Terminates a practitioner's tenant-level specialty association and optionally propagates the termination to related specialty records at the group, location, and network levels. Use this when a practitioner's specialty should be ended; to correct a wrongly recorded specialty rather than end it, use PATCH /practitioners/tenant-practitioner-specialties/specialty instead. The base request requires tenantPractitionerSpecialtyId and terminationDate; cascading to the group level is optional via a groupTerminations list, each entry requiring only tenantGroupPractitionerId plus optional scope-narrowing IDs. This endpoint does not apply the active-credentialing/monitoring-workflow guard used by PUT /practitioners/terminate, so it never returns a 409 for that reason.

put/practitioners/tenant-practitioner-specialties/terminate

Headers

tenant-idstring

Request body

tenantPractitionerSpecialtyIdstring required

The ID of the TenantPractitionerSpecialty to terminate (required)

terminationDatestring required

Termination effective date (YYYY-MM-DD)

terminationReasonstring

Termination reason

terminationInformedDatestring

Date when termination was informed (YYYY-MM-DD)

continuityOfCareboolean

Whether Continuity of Care applies for this termination. Defaults to false when omitted.

Example request

{
  "tenantPractitionerSpecialtyId": "tps_abc123",
  "terminationDate": "2025-10-25",
  "terminationReason": "Practitioner left practice",
  "terminationInformedDate": "2025-10-20",
  "groupTerminations": [
    {
      "tenantGroupPractitionerId": "tgp_abc123",
      "tenantSpecialtyId": "ts_abc123",
      "tenantGroupPractitionerSpecialtyId": "tgps_abc123",
      "tenantGroupPractitionerNetworkId": "tgpn_abc123",
      "tenantGroupPractitionerLocationId": "tgpl_abc123",
      "tenantGroupLocationPractitionerNetworkId": "tglpn_abc123",
      "tenantGroupPractitionerLocationSpecialtyId": "tgpls_abc123"
    }
  ]
}

Response

Tenant practitioner specialty terminated successfully. The response is a message/tenantPractitionerSpecialtyId map; when groupTerminations cascading is supplied, a third key, groupTerminationsCount, is included.