---
title: "Record actual outcome"
method: PUT
path: "/api/v1/estimates/{estimate_id}/actual"
tags: ["Estimates"]
---

# Record actual outcome

`PUT /api/v1/estimates/{estimate_id}/actual`

## Request

- Base URL: `https://fermi.kromatic.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fermi.kromatic.com/api/v1/estimates/{estimate_id}/actual`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Record the actual value for a past estimate. Used for calibration measurement.

## Path parameters

- `estimate_id` string, required

## Request body

- EstimateActualRequest
  - `actual_value` number, required
  - `actual_unit` string, nullable
  - `actual_recorded_at` string, date-time, nullable
  - `actual_notes` string, nullable
  - `source_inputs` EstimateSourceInput[]
    - `source_type` 'qualitative_text' | 'spreadsheet' | 'structured_file', required
    - `title` string, nullable
    - `content` string, nullable
    - `structured_data` union
      - object
      - object[]
    - `file_name` string, nullable
    - `media_type` string, nullable
    - `provenance` 'user' | 'agent' | 'file_upload'

## Response `200`

Successful Response

- EstimateActualResponse
  - `estimate_id` string, required
  - `actual` EstimateActualRecord, required
    - `value` number, required
    - `unit` string, nullable
    - `recorded_at` string, date-time, required
    - `notes` string, nullable
    - `source_inputs` EstimateSourceInput[]
      - `source_type` 'qualitative_text' | 'spreadsheet' | 'structured_file', required
      - `title` string, nullable
      - `content` string, nullable
      - `structured_data` union
        - object
        - object[]
      - `file_name` string, nullable
      - `media_type` string, nullable
      - `provenance` 'user' | 'agent' | 'file_upload'

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kromatic/apis/fermi.md) · [All operations](https://skmtc.dev/kromatic/apis/fermi/llms.txt) · [OpenAPI document](https://skmtc.dev/kromatic/apis/fermi/revisions/75a37f8067c2?raw)