---
search:
  tags:
    - Library placements
    - PATCH
seo:
  description: >-
    Changes the name, the description or the rules of a Placement of your…
    Reference for the PATCH /library/placements/{placementId} endpoint in the
    AdCrunch API.
sidebar:
  label: Update a Placement
  badge: PATCH
title: Update a Placement
type: openapi-operation
---
Changes the name, the description or the rules of a Placement of your organization. A field that the body leaves out stays as it is. The rules are checked against the type that the Placement already has.

`channel` and `type` never change. The Placement can change while Variations name it. A global Placement cannot change: it answers `404`.

`PATCH /library/placements/{placementId}`

**Request body** (`application/json`, required)

- `description` (string | null) — The new description. Send \`null\` or an empty string to remove it. Leave it out to keep it.
- `name` (string) — The name, 1 to 80 characters. AdCrunch trims it. It must be unique, ignoring case, among the ones that your organization sees.
- `rules` (object[]) — The new list of rules. It replaces the whole list. Leave it out to keep the rules.

Request body example:

```json
{
  "rules": [
    {
      "operator": {
        "condition": "eq",
        "value": [
          9,
          16
        ]
      },
      "type": "ratio"
    },
    {
      "operator": {
        "condition": "lte",
        "value": 15000
      },
      "type": "duration"
    }
  ]
}
```

**Responses**

- `200` — The Placement, with the change.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or the rules do not fit the type of the Placement: a \`duration\` rule on an image. Then \`error\` is \`invalid\_rules\`.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`library:write\`. \`error\` is \`forbidden\`.
- `404` — No Placement of your organization with that id. A global Placement answers this too, because only AdCrunch changes one. \`error\` is \`not\_found\`.
- `409` — Another live Placement of the same channel that your organization sees holds this name, ignoring case. \`error\` is \`name\_taken\`.

Response example, 200:

```json
{
  "channel": "meta",
  "createdAt": 1790000500000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "description": "Our own cut for Reels, never over 30 seconds.",
  "id": "plm_4b8d27",
  "isGlobal": false,
  "name": "Reels short cut",
  "organizationId": "org_3a7f10",
  "params": {
    "rules": [
      {
        "operator": {
          "condition": "eq",
          "value": [
            9,
            16
          ]
        },
        "type": "ratio"
      },
      {
        "operator": {
          "condition": "lte",
          "value": 15000
        },
        "type": "duration"
      }
    ],
    "type": "video"
  },
  "type": "video",
  "updatedAt": 1790000900000
}
```
