latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Set termination date on a single practitioner role assignment

Sets the terminationDate on a single role entry within a practitioner's location-network assignment. This operation is scoped to a single role in a single assignment and does not cascade to any parent records — the location-network assignment itself, the network participation record, or the practitioner's main termination status. Use it when a specific role held at a particular location-network pairing has ended but the practitioner's other roles and assignments remain active; for practitioner-wide termination, use PUT /practitioners/terminate instead. {id} is the location-network assignment (TGLPN) identifier obtained from the practitioner's relationship data, and the target role key must exist within that assignment; 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 as a legacy-record accommodation.

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.

continuityOfCareboolean

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

Example request

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

Response

Echoes tglpnId, role (canonical casing), and terminationDate; terminationInformedDate and terminationReason are accepted in the request body and persisted but not included in the response.

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