---
title: "Trigger a conversation-analysis sweep on demand (super-admin)"
method: POST
path: "/v3/conversation-analysis/{channel}/sweep"
tags: ["v3", "conversation-analysis"]
---

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

`POST /v3/conversation-analysis/{channel}/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/conversation-analysis/{channel}/sweep`
- Auth: HTTP bearer

Fires the backstop Claim sweep per channel analyzer using
deterministic workflow IDs shared with the cron schedules. Each sweep
now analyzes its claimed entities synchronously (ENG-2264 — no Submit/
Poll stages).

## Path parameters

- `channel` 'email' | 'text' | 'whatsapp', required: Conversation channel.

## Request body

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

## Response `202`

Successful Response

- ConversationAnalysisSweepResponse: 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)