---
title: "Upgrade Simulation To Ucp"
method: POST
path: "/simulations/{simulation_id}/upgrade"
tags: ["Simulations"]
---

# Upgrade Simulation To Ucp

`POST /simulations/{simulation_id}/upgrade`

Explicitly upgrade a simulation to UCPSolution format.

This triggers a re-run of the simulation to generate and store the UCPSolution
file, enabling lazy variable evaluation for future requests.

Parameters
----------
simulation_id : str
    ID of the simulation to upgrade

Returns
-------
dict
    Status information about the upgrade
    - If already upgraded: returns current solution_storage_path
    - If upgrade triggered: returns 202 with job_id

Raises
------
HTTPException
    202 if re-run is triggered
    404 if simulation not found

## Path parameters

- `simulation_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)