WRITE — Save a scenario in K-Φ, so it appears in the app's Simulation page with its levers (and can be run again with kphi_run_scenario)

WRITE — Save a scenario in K-Φ, so it appears in the app's Simulation page with its levers (and can be run again with kphi_run_scenario). Give a name and the levers ([{ type, params }], see kphi_scenario_levers); pass scenario_id to replace the levers of a scenario saved before. Call only after kphi_run_scenario on the same levers, and pass the same scope (version, period, entity, BU): a custom lever's account class is resolved on it. The result lists the stored levers with their classes — report them. Requires the mcp:write scope.

post/api/v1/save_scenario

Request

  • Base URL: https://k-phi.com (the document declares no server; this is the origin it was published from)
  • URL: https://k-phi.com/api/v1/save_scenario
  • Auth: HTTP bearer

Request body

versionstring

GL version label (e.g. "2026-06"), from kphi_list_versions. Required when more than one version exists: without it the tool answers needs_version with the list instead of picking one.

periodstring

Filter to a single period (YYYY-MM). Omit to include all periods in the version.

entitystring

Filter to a single entity code. Omit for consolidated view across all entities.

bustring

Filter to a single business unit. Omit for all BUs.

namestring required

e.g. "Salaries +10% from January"

scenario_idstring

Replace this saved scenario instead of creating one.

Response

OK

dataobject

Changes

No recorded changes to this operation across all 1 revision of this API.