Add a hospital affiliation to a practitioner
POST/practitioners/:practitionerId/hospital-affiliations
Creates a new hospital affiliation entry on the practitioner record; the server assigns a stable UUID v4 as the affiliation identifier and returns the full affiliation in the response body. Use this when a practitioner gains a new hospital affiliation that needs to be recorded; no Location header is returned in the 201 response, so use the id field in the response body to reference the created affiliation. {practitionerId} is the certifyPractitionerId, and the hospital affiliations feature must be enabled for the tenant (403 returned if not). Only name and type are required; all other fields are optional, and endDate must be on or after startDate when both are supplied.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
The full HospitalAffiliationResponse, including the server-assigned id.
Validation error
Unauthorized
Forbidden — caller lacks UPDATE_PRACTITIONER or feature disabled
Practitioner not found
Duplicate (name, type) for this practitioner — a case-insensitive match on the existing affiliations' (name, type) pair, returned with reason DUPLICATE_HOSPITAL_AFFILIATION.