---
title: "Update forecast model header (label, businessType, startCashCents, horizonMonths)"
method: PUT
path: "/companies/{companyId}/forecast/{modelId}"
tags: ["Forecast"]
---

# Update forecast model header (label, businessType, startCashCents, horizonMonths)

`PUT /companies/{companyId}/forecast/{modelId}`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/forecast/{modelId}`
- Auth: HTTP bearer

## Request body

- UpdateForecastModelInput
  - `label` string
  - `businessType` 'software' | 'services' | 'digital' | 'usage' | 'license' | 'blended' | 'custom'
  - `startCashCents` integer
  - `horizonMonths` 12 | 18 | 24

## Response `200`

Updated forecast model

- object
  - `success` boolean
  - `data` ForecastModel
    - `id` string, uuid, required
    - `companyId` string, uuid, required
    - `entityId` string, uuid, required
    - `label` string, required
    - `businessType` 'software' | 'services' | 'digital' | 'usage' | 'license' | 'blended' | 'custom', required
    - `startCashCents` integer, required: Starting cash in the model's authoritative minor units
    - `horizonMonths` 12 | 18 | 24, required
    - `currency` string, required: Server-owned legal-entity functional currency
    - `minorUnitExponent` 2, required: Server-owned scale for every monetary integer in this Forecast model
    - `moneyAuthorityVersion` 1, required
    - `source` 'unknown' | 'manual' | 'books', required: Provenance of the model's opening cash boundary
    - `sourceMetadata` object, required: Non-secret authority metadata such as closed period, anchor, and functional currency
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `422`: Validation error

---

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