---
title: "Disable placement rules"
type: reference
method: POST
path: /rest-api/rules/placement/{placementId}/disable.do
tag: "Targeting Rules"
---

# Disable placement rules

`POST https://YOUR-NETWORK-DOMAIN/rest-api/rules/placement/{placementId}/disable.do`

Deactivates the targeting rules engine for the specified placement, so its rule groups no longer affect ad serving decisions. The placement is identified by its numeric ID in the URL path. The response is a JSON object with 'success: true' on success. Requires UPDATE permission on the placement's parent site inventory share and INVENTORY_RULES_MANAGEMENT permission. The action is logged for audit purposes. 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 |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | The unique numeric identifier of the placement whose targeting rules should be disabled |

## Responses

- `200` — Rules disabled successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized - authentication error
- `403` — Forbidden - insufficient permissions
- `404` — Placement not found

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/rules/placement/4001/disable.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/post-rules-placement-disable