---
title: "Update Engagement"
method: PATCH
path: "/v1/engagements/{engagement_id}"
tags: ["Engagements"]
---

# Update Engagement

`PATCH /v1/engagements/{engagement_id}`

**🔐 This endpoint requires [HTTP Bearer authentication](https://docs.constructor.com/reference/main-authentication#bearer-authentication).**
For authenticating with Bearer token, required scopes are: `retail_media.engagements(w)`.

**Beta:** This endpoint is in beta and may change. Updates the suspension status of an advertiser engagement. When suspended, the engagement's ads will stop serving. When unsuspended, the engagement's ads will resume serving.

## Path parameters

- `engagement_id` string, required — The advertiser engagement ID.

## Query parameters

- `key` string, required — The key of the index to use.

## Request body

- EngagementUpdateRequest
  - `is_suspended` boolean, required — Whether the engagement is suspended.

## Response `200`

Successful Response.

- EngagementResponse
  - `engagement_id` string, required — The advertiser engagement ID.
  - `key` string, required — The key of the index.
  - `is_suspended` boolean, required — Whether the engagement is suspended.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)