---
title: "Soft-delete engagements removed upstream within a window"
method: POST
path: "/v1/integrations/sync/engagements/soft-delete-removed"
---

# Soft-delete engagements removed upstream within a window

`POST /v1/integrations/sync/engagements/soft-delete-removed`

Given an exhaustive set of engagement externalIds for a startTime window, soft-delete any engagements on this connection in that window that are not in the set.

## Request body

- object
  - `validExternalIds` string[], required — Exhaustive set of engagement externalIds currently present upstream for this window. Any engagement on this connection whose startTime falls in [fromTime, toTime] but is NOT in this list will be soft-deleted.
  - `fromTime` string, date-time, required — Inclusive lower bound on engagement.startTime.
  - `toTime` string, date-time, required — Inclusive upper bound on engagement.startTime.

## Response `200`

Soft-delete engagements removed upstream within a window

- object
  - `data` object, required
    - `success` boolean, required

---

[API](https://skmtc.dev/siro/apis/swagger-api.md) · [All operations](https://skmtc.dev/siro/apis/swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siro/swagger-api/revisions/9995339a94c6/schema)