---
title: "Apply an edit that no longer applies to a rebuilt position"
method: POST
path: "/api/position_overrides/{override_heron_id}/reannotate"
tags: ["Positions"]
---

# Apply an edit that no longer applies to a rebuilt position

`POST /api/position_overrides/{override_heron_id}/reannotate`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/position_overrides/{override_heron_id}/reannotate`
- Auth: API key in header `x-api-key`

Saves the stale edit's values against the chosen position, continuing its edit history.

## Path parameters

- `override_heron_id` string, required

## Request body

- ReannotatePositionOverrideRequest
  - `position_heron_id` string, required: Rebuilt position to apply the edit to

## Response `201`

Edit applied

- PositionOverride
  - `created` string, date-time
  - `created_by` string: Email of the person who made the edit
  - `heron_id` string: Heron ID of the override
  - `is_deleted` boolean, nullable
  - `latest_repayment_amount` number, nullable
  - `merchant_name` string, nullable: Funder of the edited position
  - `original_latest_repayment_amount` number, nullable
  - `original_repayment_frequency` 'not_enough_data' | 'same_day' | 'irregular' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'annually' | 'weekday' | 'twice_weekly' | 'null', nullable
  - `original_status` 'none' | 'active' | 'inactive' | 'defaulted' | 'potential_default' | 'renewal_active' | 'renewal_inactive' | 'new_position' | 'likely_paid_off'
  - `position_heron_id` unknown
  - `position_override_set_id` string, uuid: Shared by every edit to the same position
  - `product_type` 'mca' | 'line_of_credit' | 'reverse_consolidation' | 'revenue_share'
  - `repayment_frequency` 'not_enough_data' | 'same_day' | 'irregular' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'annually' | 'weekday' | 'twice_weekly' | 'null', nullable
  - `status` 'none' | 'active' | 'inactive' | 'defaulted' | 'potential_default' | 'renewal_active' | 'renewal_inactive' | 'new_position' | 'likely_paid_off' | 'null', nullable

## Other responses

- `404`: Stale edit or position not found
- `409`: The end user is still processing
- `422`: The position already has an override

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/position_overrides/:override_heron_id/reannotate/post.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)