latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Partially update a practitioner hospital affiliation

Applies a partial update to the specified hospital affiliation; only the fields included in the request body are modified, and absent fields are left unchanged. Use this when one or more attributes of an existing hospital affiliation need to be corrected or updated without replacing the entire record. {practitionerId} is the certifyPractitionerId, {affiliationId} is the UUID assigned by the server when the affiliation was created, and the hospital affiliations feature must be enabled for the tenant. The updatable field set matches HospitalAffiliationResponse (the same class returned by the GET and POST endpoints), and the merge is checked against the same case-insensitive (name, type) duplicate-detection used on create.

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

The updated HospitalAffiliationResponse.

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