latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Replace education and training records for a practitioner

Replaces the practitioner's education and training records using per-item create, update, or delete actions. Submitting an empty array removes all education and training entries for this practitioner — this is a destructive, full-array replacement that cannot be partially reversed in the same call. Use this to synchronize a practitioner's education history, such as medical schools, residencies, and fellowships, with the authoritative source; for targeted removal of a single entry, send an explicit delete action with the stable row ID rather than submitting an empty array. {id} is the certifyPractitionerId, each item in the array must include an action field, and stable row IDs are required for update and delete actions.

put/practitioners/{id}/education-training

Path parameters

idstring required

Practitioner ID

Headers

tenant-idstring

Request body

idstring

Stable row identifier (UUID)

typestring

Education or training type

institutionstring

Institution name

degreestring

Degree or program

specialtystring

Medical specialty (stored as speciality in Core schema)

subspecialtystring

Subspecialty

startDatestring date
endDatestring date
sourcestring

Source of the record (e.g. Manual, Roster)

statusstring

Completion status when applicable

actionstring

Action to perform: create, update, or delete

Example request

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "Residency",
    "institution": "Harvard Medical School",
    "degree": "MD",
    "source": "Manual",
    "status": "Completed",
    "action": "create"
  }
]

Response

Practitioner education and training updated successfully