Update practitioner location associations within a group
PUT/practitioners/:practitionerId/locations
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.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Successfully updated practitioner location associations. The response is a tenantGroupPractitionerId plus a locationAssociations array, each entry containing tenantGroupLocationId, groupPractitionerLocationId, status, and networks.
Bad request - Invalid input or validation error
Unauthorized - Authentication required
Forbidden - Insufficient permissions
Practitioner or location not found
Internal server error