---
title: Update Location Group
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/update-location-group
---

# Update Location Group

Update an existing location group’s name, rules, or location membership.

## URL

PUT https://api.ads.apple.com/v1/location-groups/{id}

## Path Parameters

id:

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion The system modifies only the fields you include in the request body. Omitted fields retain their current values. See LocationGroupUpdate for the request body’s accepted fields, including which ones are mutable. The brandId and adAccountId fields can’t change after creation, and the update request body doesn’t accept them. To move a group to a different brand or transfer ownership to another ad account, delete the group and recreate it. The locationIds and rules fields use full-replacement semantics: the value you send becomes the entire list, not a diff against the existing one, since the API doesn’t support partial updates within an array. To add a single location to a STATIC group, retrieve the current locationIds array, append the new ID, and send the complete list. When you add or update rules on a DYNAMIC group, systemStatus transitions to PENDING while the system evaluates membership, and groupTotal keeps its last known value until evaluation completes. Updating only name or description leaves systemStatus, groupTotal, and membership unchanged. Because an ad group displays the place card for each location in its assigned location group, changing a group’s membership changes which place cards appear once evaluation (if triggered) completes. Payload Examples

## See Also

- [Create Location Group](apple-ads-platform-api/create-location-group.md)
- [Query Location Groups](apple-ads-platform-api/query-location-groups.md)
- [Get Location Group](apple-ads-platform-api/get-location-group-by-id.md)
- [Delete Location Group](apple-ads-platform-api/delete-location-group.md)