---
search:
  tags:
    - Library placement groups
    - PATCH
seo:
  description: >-
    Changes the name or the description of a Placement group of your… Reference
    for the PATCH /library/placement-groups/{groupId} endpoint in the AdCrunch
    API.
sidebar:
  label: Update a Placement group
  badge: PATCH
title: Update a Placement group
type: openapi-operation
---
Changes the name or the description of a Placement group of your organization. A field that the body leaves out stays as it is. A global group cannot change: it answers `404`. To change what the group holds, add or remove a Placement.

`PATCH /library/placement-groups/{groupId}`

**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.

Request body example:

```json
{
  "name": "Vertical cuts"
}
```

**Responses**

- `200` — The group, 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.
- `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 group of your organization with that id. A global group answers this too, because only AdCrunch changes one. \`error\` is \`not\_found\`.
- `409` — Another live group that your organization sees holds this name, ignoring case. \`error\` is \`name\_taken\`.

Response example, 200:

```json
{
  "createdAt": 1790000600000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "description": null,
  "id": "plg_9e1c53",
  "isGlobal": false,
  "name": "Vertical cuts",
  "organizationId": "org_3a7f10",
  "updatedAt": 1790000900000
}
```
