---
title: "Create or run document artifacts promote"
method: POST
path: "/accountant/document-artifacts/{artifactId}/promote"
tags: ["Accountant Portal"]
---

# Create or run document artifacts promote

`POST /accountant/document-artifacts/{artifactId}/promote`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/document-artifacts/{artifactId}/promote`
- Auth: HTTP bearer

Generated minimal contract (#1940): parameters, auth, and status codes are authoritative; see the route handler for the exact body/response shape. Enrichment tracked by the x-median-spec-stage marker.

## Request body

- object

## Response `200`

Success envelope; see the route handler for the payload shape

- object

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `409`: The artifact is no longer in the review queue (already promoted, archived, rejected, or marked as a repeat), or a live document already exists for the same attachment (#3198). Nothing is written.

---

[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)