---
title: "Prepare or stop an exact-thread reply"
method: POST
path: "/outreach/exact-thread-replies"
---

# Prepare or stop an exact-thread reply

`POST /outreach/exact-thread-replies`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/outreach/exact-thread-replies`
- Auth: HTTP bearer

Evaluates and persists a reply or follow-up against server-owned account, exact provider thread/message receipt, suppression, approval, and identity evidence. Requires a signed-in BAMF user session and Idempotency-Key. It returns prepared or stopped and never invokes or sends through a provider.

## Headers

- `Idempotency-Key` string, required

## Request body

- ExactThreadReplyPrepareRequest
  - `workspace_id` string, uuid, required
  - `intent` object, required
    - `version` 'exact-thread-reply/v1', required
    - `account_ref` string, required
    - `channel` 'linkedin' | 'gmail' | 'x' | 'instagram', required
    - `action` 'reply' | 'follow_up', required
    - `draft_id` string, required
    - `draft_revision` integer, required
    - `draft_sha256` string, required
    - `approval_id` string, required
    - `thread` object, required
      - `provider_thread_id` string, required
      - `source_message_id` string, required
      - `provider_receipt_id` string, required
      - `observed_at` string, date-time, required
    - `identity` object, required
      - `evidence_id` string, required
      - `subject_id` string, required
      - `linkedin_profile_url` string, nullable, required
      - `gmail_address` string, nullable, required
      - `observed_at` string, date-time, required
      - `expires_at` string, date-time, required

## Response `200`

Redacted prepared/stopped decision receipt; providerMutation and sendAvailable are false

## Other responses

- `403`: JWT session or workspace scope required
- `409`: Idempotency key conflicts with a different request

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/2337a0710c2e?raw)