> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Placement

> Rename a placement or change its size hints

Changes a [placement](https://docs.sequenzy.com/concepts/in-app-placements.md)'s name, description or size hints. Send at least one field; fields you leave out keep their value, and `null` clears a size hint. The key cannot change, because your app's code uses it. What contacts see is unaffected. Requires the `sequences:write` scope.

## Request

**key** `string` *required*

The placement key.

**name** `string`

New name, up to 100 characters.

**description** `string`

New description, up to 500 characters.

**width** `integer | null`

Width hint in points, 1 to 4000, or `null` to clear it.

**height** `integer | null`

Height hint in points, 1 to 4000, or `null` to clear it.

```bash theme={null}
curl -X PATCH "https://api.sequenzy.com/api/v1/in-app/placements/home_hero" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "name": "Home banner", "height": null }'
```

```json 200 theme={null}
{
  "success": true,
  "placement": {
    "key": "home_hero",
    "name": "Home banner",
    "description": "",
    "width": 360,
    "height": null,
    "createdAt": "2026-11-07T10:00:00.000Z",
    "updatedAt": "2026-11-07T11:00:00.000Z"
  }
}
```

```json 400 theme={null}
{
  "error": "Provide at least one of name, description, width or height"
}
```

```json 401 theme={null}
{
  "error": "Invalid API key"
}
```

```json 403 theme={null}
{
  "error": "API key is missing required scope: sequences:write"
}
```

```json 404 theme={null}
{
  "error": "Placement \"home_hero\" not found."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.