latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Remove a role from a practitioner-location record

Removes a role key from the specified practitioner-location association record and from all associated location-network assignment records for that location. Use this to fully remove a role at the group-practitioner-location level; this is not a termination, it deletes the role key entirely. For terminating a role (setting a termination date) on a specific network assignment, use PUT /practitioners/practitioner-role-assignments/{id}/terminate instead. {id} is the GroupPractitionerLocation record identifier, and the role being removed must exist on the record. This endpoint does not apply the active-credentialing/monitoring-workflow guard used by PUT /practitioners/terminate.

patch/practitioners/practitioner-locations/{id}/roles/remove

Path parameters

idstring required

Headers

tenant-idstring

Request body

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

Role key to remove (will be normalized to lowercase)

Example request

{
  "role": "PCP"
}

Response

A PractitionerRolesUpdateResponse payload reflecting the role removal. practitionerRoles is always empty; locationRoles has a single entry keyed by groupPractitionerLocationId.

practitionerRolesobject

Updated practitioner roles map from core_practitioners

locationRolesobject

Updated practitioner roles map from group_practitioner_locations, keyed by groupPractitionerLocationId

Example response

{
  "practitionerRoles": {
    "pcp": {
      "effectiveDate": "2026-01-10",
      "terminationDate": "2026-02-02"
    },
    "specialist": {
      "effectiveDate": "2026-01-01"
    }
  },
  "locationRoles": {
    "550e8400-e29b-41d4-a716-446655440000": {
      "pcp": {
        "effectiveDate": "2026-01-10",
        "terminationDate": "2026-02-02"
      }
    }
  }
}