---
title: "Atomically create and seal a complete hierarchy snapshot"
method: POST
path: "/companies/{companyId}/reporting-scopes/{reportingScopeId}/versions"
tags: ["Company Settings"]
---

# Atomically create and seal a complete hierarchy snapshot

`POST /companies/{companyId}/reporting-scopes/{reportingScopeId}/versions`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/reporting-scopes/{reportingScopeId}/versions`
- Auth: HTTP bearer

Owner/admin plus explicit all-entity access required. The snapshot must contain every current same-company legal entity exactly once, use the primary entity as its 100 percent full-consolidation root, and be connected and acyclic. A successor closes the prior open version in the same transaction.

## Request body

- CreateReportingScopeVersionInput
  - `effectiveFrom` string, date, required
  - `presentationCurrency` string, required
  - `entities` ReportingScopeVersionEntity[], required
    - `entityId` string, uuid, required
    - `parentEntityId` string, uuid, nullable, required
    - `ownershipPct` number, required
    - `consolidationMethod` 'full' | 'equity' | 'proportional', required

## Response `201`

Sealed reporting-scope hierarchy version

- ReportingScopeVersionResponse
  - `success` boolean, required
  - `data` ReportingScopeVersion, required
    - `id` string, uuid, required
    - `reportingScopeId` string, uuid, required
    - `companyId` string, uuid, required
    - `effectiveFrom` string, date, required
    - `effectiveTo` string, date, nullable, required
    - `presentationCurrency` string, required
    - `createdByUserId` string, uuid, required
    - `createdAt` string, date-time, required
    - `sealedAt` string, date-time, required
    - `entities` ReportingScopeVersionEntity[], required
      - `entityId` string, uuid, required
      - `parentEntityId` string, uuid, nullable, required
      - `ownershipPct` number, required
      - `consolidationMethod` 'full' | 'equity' | 'proportional', required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `409`: Effective dates or persisted reporting authority conflict
- `422`: Request failed validation

---

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