Delete Location Group
Delete a location group by its unique identifier.
URL
DELETE https://api.ads.apple.com/v1/location-groups/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | LocationGroupResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | Error | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | LocationGroupResponse | |
| 429 | Too Many Requests Content-Type: application/json | Error | |
| 500 | Internal Server Error Content-Type: application/json | Error |
Discussion
This endpoint soft-deletes the location group. The system doesn’t physically remove the record. Instead, it marks the record with systemStatus: DELETED and excludes it from query results and ad group targeting lookups. Deletion is permanent. There is no restore operation.
Downstream Effects
Ad groups that reference the deleted location group lose that targeting constraint immediately and will only continue to serve if they are targeting other location groups.
Deletion carries a few important caveats:
Constraint | Detail |
|---|---|
Permanent | Deleted groups cannot be restored. Create a new group to replace a deleted one. |
Still retrievable | A deleted group can still be fetched by ID and appears in queries that include a |
Targeting impact | Ad groups referencing a deleted group lose the location constraint immediately upon deletion. |