Sign in

v1

latestOpenAPI 3.1.02026-08-063776831.4 MB
Practitioner

Partially update a hospital affiliation

Applies a partial update to the affiliation identified by {affiliationId}. Fields that are absent from the request body are left unchanged. Returns the updated HospitalAffiliationResponse.

patch/practitioners/{practitionerId}/hospital-affiliations/{affiliationId}

Path parameters

affiliationIdstring required
practitionerIdstring required

Headers

tenant-idstring

Request body

namestring

Hospital name

typestring

Type of affiliation

specialtystring

Specialty practiced at the hospital

statestring

State where hospital is located

source'MANUAL' | 'ROSTER' | 'CAQH'

Source-of-truth tag for a practitioner-level hospital affiliation. Accepts MANUAL, ROSTER, CAQH (any case), or the legacy long-form CAQH label. Always serializes the canonical short label.

startDatestring date
endDatestring date
statusstring

Status of the affiliation

Example request

{
  "name": "General Hospital",
  "type": "Admitting",
  "specialty": "Cardiology",
  "state": "NY",
  "startDate": "2022-03-10",
  "endDate": "2022-03-10",
  "status": "Active"
}

Response

Updated

idstring required

Stable UUID v4 identifying this affiliation. For legacy entries this may be a deterministic synthesized UUID until the next write backfills a real one.

namestring

Hospital name

typestring

Type of affiliation

specialtystring

Specialty practiced at the hospital

statestring

State where hospital is located

source'MANUAL' | 'ROSTER' | 'CAQH'

Source-of-truth tag for a practitioner-level hospital affiliation. Accepts MANUAL, ROSTER, CAQH (any case), or the legacy long-form CAQH label. Always serializes the canonical short label.

startDatestring

Start date of affiliation in YYYY-MM-DD format

endDatestring

End date of affiliation in YYYY-MM-DD format

statusstring

Status of the affiliation

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "General Hospital",
  "type": "Admitting",
  "specialty": "Cardiology",
  "state": "NY",
  "startDate": "2026-01-01",
  "endDate": "2027-12-31",
  "status": "Active"
}