latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Remove a role from the core practitioner record

Removes a role key from the core practitioner record; the role is set to null and stripped, so it will no longer be included when the practitioner's profile is composed from source records. Use this to permanently remove a role at the core practitioner level — this is not a termination, it removes the role entry entirely rather than setting a termination date. For terminating a role at a specific location-network assignment, use PUT /practitioners/practitioner-role-assignments/{id}/terminate; for removing a role at the group-practitioner-location level, use PATCH /practitioners/practitioner-locations/{id}/roles/remove. {id} is the certifyPractitionerId, and the role key being removed must exist on the core practitioner record.

patch/practitioners/{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

Role removed successfully. practitionerRoles reflects the core roles map with the removed role key filtered out entirely (absent, not null); locationRoles is always empty.

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"
      }
    }
  }
}