v1

latestOpenAPI 3.1.02026-08-063776831.4 MB

Practitioner

Update practitioner roles

Updates practitioner roles at the core practitioner level and optionally at the group practitioner location level. Accepts an array of role updates. Each role is upserted (added if missing, updated if exists) in the practitionerRoles map.

put/practitioners/{id}/roles

Path parameters

idstring required

Practitioner ID

Headers

tenant-idstring

Request body

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

Role type

effectiveDatestring

Role effective date (ISO 8601 format)

terminationDatestring

Role termination date (ISO 8601 format)

groupPractitionerLocationIdstring

Optional group practitioner location ID. If omitted, only core practitioner will be updated

Example request

[
  {
    "role": "PCP",
    "effectiveDate": "2026-01-10",
    "terminationDate": "2026-02-02",
    "groupPractitionerLocationId": "550e8400-e29b-41d4-a716-446655440000"
  }
]

Response

Practitioner roles updated successfully

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