563848e0ecc0
Associate or update practitioner locations within a group
Associates the practitioner with one or more locations within the specified group, or updates existing location associations. Each location entry may include locationData with an npi field as a single string or array of strings for multi-NPI locations. Use this when adding the practitioner to locations within a group, or when updating group-practice location details such as location NPIs; this endpoint handles both creation and update of GroupPractitionerLocation relationships and optionally also creates TenantGroupLocationPractitionerNetwork relationships for location-specific networks. {practitionerId} is the certifyPractitionerId, and {groupId} in the path must match the groupId in the request body — a mismatch returns 400.
Path parameters
ID of the group
ID of the practitioner (certify practitioner ID)
Headers
Request body
Example request
{
"groupId": "group-123",
"locations": [
{
"tenantGroupLocationId": "loc-123"
}
]
}Response
Successfully associated practitioner with group locations. The response is a tenantGroupPractitionerId, groupId, and a locations array (no status field, unlike the sibling PUT /practitioners/{practitionerId}/locations response).
Example response
{
"tenantGroupPractitionerId": "tgp-456",
"groupId": "group-123",
"locations": [
{
"tenantGroupLocationId": "loc-123",
"groupPractitionerLocationId": "gpl-789",
"networks": [
{
"networkId": "net-123",
"tenantGroupLocationPractitionerNetworkId": "tglpn-456"
}
]
}
]
}