---
title: "Super-admin auto-apply of high-confidence engine document-match proposals"
method: POST
path: "/companies/{companyId}/documents/match-proposals/auto-apply"
tags: ["Documents"]
---

# Super-admin auto-apply of high-confidence engine document-match proposals

`POST /companies/{companyId}/documents/match-proposals/auto-apply`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/documents/match-proposals/auto-apply`
- Auth: HTTP bearer

Super-admin Stage-1 sweep. Promotes high-precision engine document↔transaction match proposals (method exact_amount_date_vendor, confidence >= minConfidence, expense document -> outflow transaction, single unambiguous candidate, and current amount/date/vendor evidence still matching) to applied matches, reusing the standard match path so GL side-effects and reconciliation guards are inherited. Defaults to a dry-run; pass dryRun=false to write.

## Request body

- object
  - `dryRun` boolean
  - `minConfidence` number
  - `limit` integer

## Response `200`

Sweep summary with exact document/transaction identities

- DocumentMatchAutoApplyResponse
  - `success` boolean, required
  - `data` object, required
    - `scanned` integer, required
    - `applied` integer, required
    - `skipped` integer, required
    - `skipReasons` object, required
    - `appliedPairs` object[], required
      - `documentId` string, uuid, required
      - `transactionId` string, uuid, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)