563848e0ecc0
Update practitioner location associations within a group
Creates or updates the practitioner's location associations within a group, following upsert semantics — existing associations are updated in place. Each location entry may include locationData with an npi field as a single string or array of strings; omitted fields are preserved when merging with existing data. Use this when adding the practitioner to locations or updating location-specific data such as group-practice location NPIs; the request body must include a groupId to scope the associations. {practitionerId} is the certifyPractitionerId, and the group identified by groupId in the request body must already be associated with the practitioner. Only the locations present in the request are upserted — locations already associated with the practitioner but omitted from the request are left unchanged, not removed.
Path parameters
ID of the practitioner (certify practitioner ID)
Headers
Request body
Example request
{
"tenantGroupId": "group-123",
"locations": [
{
"tenantGroupLocationId": "loc-123"
}
]
}Response
Successfully updated practitioner location associations. The response is a tenantGroupPractitionerId plus a locationAssociations array, each entry containing tenantGroupLocationId, groupPractitionerLocationId, status, and networks.
Example response
{
"tenantGroupPractitionerId": "tgp-456",
"locationAssociations": [
{
"tenantGroupLocationId": "loc-123",
"groupPractitionerLocationId": "gpl-789",
"status": "updated",
"networks": [
{
"networkId": "net-123",
"tenantGroupLocationPractitionerNetworkId": "tglpn-456"
}
]
}
]
}