---
title: "Remove rules group from banner"
type: reference
method: POST
path: /rest-api/rules/banner/{bannerId}/remove.do
tag: "Targeting Rules"
---

# Remove rules group from banner

`POST https://YOUR-NETWORK-DOMAIN/rest-api/rules/banner/{bannerId}/remove.do`

Permanently deletes a targeting rules group from the specified banner. The rule group is identified by the 'ruleGroupId' query parameter, and the banner by its path ID. After removal, the rules in that group will no longer affect ad serving for this banner. The response is a JSON object with 'success: true'. Requires UPDATE permission on the banner's parent advertiser campaign share and CAMPAIGN_RULES_MANAGEMENT permission. POST only: a GET answers 405, since a state change over GET can be triggered by a prefetch or an embedded link.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerId` | integer | yes | `7890` | The unique numeric identifier of the banner to remove the rules group from |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `ruleGroupId` | integer | yes | `50` | The unique numeric identifier of the rules group to remove |

## Responses

- `200` — Rules group removed successfully
- `400` — Bad request - ruleGroupId is missing
- `401` — Unauthorized - authentication error
- `403` — Forbidden - insufficient permissions
- `404` — Banner not found, or the rules group is not one of its groups

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/rules/banner/7890/remove.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'ruleGroupId=50'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/post-rules-banner-remove