---
title: "Mark a preparation as superseded because it was replaced by newer prepared work. History is never deleted."
method: POST
path: "/actions/{id}/preparations/supersede"
---

# Mark a preparation as superseded because it was replaced by newer prepared work. History is never deleted.

`POST /actions/{id}/preparations/supersede`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/actions/{id}/preparations/supersede`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `preparationId` string
  - `replacedByPreparationId` string

## Response `200`

Transitioned

- PreparationEnvelope
  - `ok` boolean
  - `owner` Owner: Ownership of the record. Never means the performer of an operation — use /actions/{id}/history for actor semantics.
    - `type` 'human'
    - `user_id` string: Owning Forbiz user. Action payloads never repeat raw ownership UUIDs.
    - `workspace_id` string, nullable
    - `note` string
  - `preparation` Preparation: External work that exists but has NOT been sent. prepared_at is when the draft existed, executed_at is when it actually left the external system, recorded_at is when Forbiz learned about it.
    - `id` string
    - `action_id` string
    - `outreach_id` string, nullable
    - `campaign_target_id` string, nullable
    - `channel` 'email' | 'phone' | 'linkedin' | 'meeting' | 'other'
    - `external_source` string
    - `external_draft_id` string, nullable
    - `external_thread_id` string, nullable
    - `recipient_snapshot` string, nullable
    - `subject_snapshot` string, nullable
    - `status` 'prepared' | 'executed' | 'superseded' | 'discarded'
    - `prepared_at` string, date-time
    - `executed_at` string, date-time, nullable
    - `recorded_at` string, date-time
  - `duplicate_preparation_rejected` boolean
  - `action_unchanged` object

## Other responses

- `208`: Idempotent replay of a previous request with the same Idempotency-Key. Nothing was applied again.
- `409`: Preparation is no longer in 'prepared' state

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)