v1

latestOpenAPI 3.1.02026-08-063776831.4 MB

Practitioner

Update practitioner location associations

Updates a practitioner's location associations following the roster ingestion pattern. Use this same endpoint to create new location associations or to edit existing ones (e.g. update or replace group practice location NPI(s)). Associates a practitioner with one or more locations within a group, creating or updating GroupPractitionerLocation relationships. Each location's locationData may include 'npi' as a single string or array of strings; omitted fields are left unchanged when merging with existing data.

put/practitioners/{practitionerId}/locations

Path parameters

practitionerIdstring required

ID of the practitioner (certify practitioner ID)

Headers

tenant-idstring

Request body

tenantGroupIdstring required

tenantGroupId (ID of the group to which the practitioner belongs)

Example request

{
  "tenantGroupId": "group-123",
  "locations": [
    {
      "tenantGroupLocationId": "loc-123"
    }
  ]
}

Response

Successfully updated practitioner location associations

tenantGroupPractitionerIdstring

ID of the tenant group practitioner

Example response

{
  "tenantGroupPractitionerId": "tgp-456",
  "locationAssociations": [
    {
      "tenantGroupLocationId": "loc-123",
      "groupPractitionerLocationId": "gpl-789",
      "status": "updated",
      "networks": [
        {
          "networkId": "net-123",
          "tenantGroupLocationPractitionerNetworkId": "tglpn-456"
        }
      ]
    }
  ]
}