Patient Facilities/Specialists

Add a specialist to a patient

Links a specialist from the master specialists database to a patient. Use either priority_order (explicit position) or set_as_primary (add to top/bottom) to control placement.

post/patients/{patient_id}/specialists

Request

  • Base URL: https://clinic-subdomain.md-hq.com/api/v1
  • URL: https://clinic-subdomain.md-hq.com/api/v1/patients/{patient_id}/specialists
  • Auth: HTTP basic

Path parameters

patient_idinteger required

The patient ID

Request body

specialist_idinteger required

The specialist ID from the master specialists database. Use the facilities/specialists endpoints to find valid IDs.

priority_orderinteger

Position in the patient's specialist list (lower = higher priority). If provided, set_as_primary is ignored.

set_as_primaryboolean

If true, adds to top of list (priority). If false, adds to bottom. Only used when priority_order is not provided.

notestring

Optional note about this specialist for the patient (max 255 characters)

Response

OK - Returns the created patient-specialist association

idinteger

Patient-specialist association ID

specialist_idinteger
priority_orderinteger
notestring nullable
createdstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.