latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Update practitioner facility associations within a group

Associates the practitioner with one or more facilities within a group, creating new associations or updating existing ones; this endpoint follows upsert semantics, so existing associations are updated in place rather than replaced wholesale. Use this when adding the practitioner to a facility or updating facility-specific data; the request body must include a groupId to scope the associations. {id} is the certifyPractitionerId, and the group identified by groupId in the request body must already be associated with the practitioner. Only the facilities present in the request are upserted — facilities already associated with the practitioner but omitted from the request are left unchanged, not removed.

put/practitioners/{id}/facilities

Path parameters

idstring required

Practitioner ID (certifyPractitionerId)

Headers

tenant-idstring

Request body

groupIdstring required

ID of the group to which the practitioner belongs

Example request

{
  "groupId": "group-123",
  "facilities": [
    {
      "tenantGroupFacilityId": "tgf-123"
    }
  ]
}

Response

Successfully updated practitioner facility associations

tenantGroupPractitionerIdstring

ID of the tenant group practitioner

Example response

{
  "tenantGroupPractitionerId": "tgp-456",
  "facilityAssociations": [
    {
      "tenantGroupFacilityId": "tgf-123",
      "tenantGroupPractitionerFacilityId": "tgpf-789",
      "status": "updated"
    }
  ]
}