Set termination date on a single practitioner role assignment
PUT/practitioners/practitioner-role-assignments/:id/terminate
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.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 500
Echoes tglpnId, role (canonical casing), and terminationDate; terminationInformedDate and terminationReason are accepted in the request body and persisted but not included in the response.
Bad request - invalid role value, terminationDate before effectiveDate, or role not found in practitionerRolesMap
Unauthorized - Authentication required
Forbidden - Insufficient permissions
TGLPN record not found
Conflict - role is already terminated
Internal server error