v1

latestOpenAPI 3.1.02026-08-063776831.4 MB

Practitioner

Terminate a practitioner role at a network location assignment

Sets the terminationDate on a single role entry inside practitionerRolesMap of a TenantGroupLocationPractitionerNetwork (TGLPN) record. Does not cascade to the parent TGLPN record status, TenantGroupPractitionerNetwork, or the practitioner's main termination. The response echoes tglpnId, role (canonical casing), and terminationDate only; terminationInformedDate and terminationReason are accepted and persisted but not returned. If the role's stored effectiveDate cannot be parsed as a valid ISO date, the termination-before-effective constraint is skipped and the request succeeds; this preserves forward progress for legacy records with malformed effectiveDate values.

put/practitioners/practitioner-role-assignments/{id}/terminate

Path parameters

idstring required

Headers

tenant-idstring

Request body

role'PCP' | 'Specialist' | 'Hospitalist' | 'Hospital-based Provider' required

Role key to terminate inside practitionerRolesMap

terminationDatestring required

ISO date (YYYY-MM-DD) on which the role is terminated. Must be on or after the role's effectiveDate when one is present.

terminationInformedDatestring

ISO date (YYYY-MM-DD) when the practitioner was informed of the role termination. Optional.

terminationReasonstring

Human-readable reason for terminating the role. Optional.

Example request

{
  "role": "PCP",
  "terminationDate": "2026-05-05"
}

Response

Role terminated successfully

tglpnIdstring

The TenantGroupLocationPractitionerNetwork record ID that was updated

rolestring

The role key that was terminated

terminationDatestring

The termination date that was applied to the role