---
title: "Trigger a phone-call-analysis sweep on demand (super-admin)"
method: POST
path: "/v3/phone-call-analysis/sweep"
tags: ["v3", "phone-call-analysis"]
---

# Trigger a phone-call-analysis sweep on demand (super-admin)

`POST /v3/phone-call-analysis/sweep`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/phone-call-analysis/sweep`
- Auth: HTTP bearer

Fires the backstop Claim sweep per phone-call analyzer using
deterministic workflow IDs shared with the cron schedules. Each sweep
now analyzes its claimed entities synchronously (ENG-2264 — no Submit/
Poll stages). ``id_conflict_policy=FAIL`` 409s when a sweep is already
in flight; ``id_reuse_policy=ALLOW_DUPLICATE`` lets the manual trigger
succeed *after* the cron tick has closed.

## Request body

- PhoneCallAnalysisSweepTrigger: Manual /sweep payload — narrow knobs the operator usually wants.
  - `created_after` string, date-time, nullable

## Response `202`

Successful Response

- PhoneCallAnalysisSweepResponse: One workflow handle per fired backstop claim sweep (one per analyzer).
  - `claim_workflow_ids` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)
