---
title: "Create Forecast What If Run"
method: POST
path: "/tokenomics/v1/forecast-what-if-runs"
tags: ["tokenomics", "forecast_config"]
---

# Create Forecast What If Run

`POST /tokenomics/v1/forecast-what-if-runs`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/tokenomics/v1/forecast-what-if-runs`
- Auth: one of:
  - API key in header `Splunk-AO-API-Key`
  - API key in header `Galileo-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic
- TypeScript: <https://skmtc.dev/galileo/apis/galileo-api-server/docs/tokenomics/v1/forecast-what-if-runs/post.ts> (a function with typed inputs; its response is checked against the schema)

Start a forecast of the view without the named teams. Poll the returned run for weekly ratios.

## Request body

- CreateForecastWhatIfRunRequest: ``view`` and ``filters.leader_user_key`` select the forecast, as on ``POST /tokenomics/v1/forecast-results``.
  - `view` 'organization' | 'team', required
  - `filters` ForecastWhatIfRunFilters
    - `leader_user_key` string, nullable
  - `fiscal_calendar_version_id` string, uuid4, required
  - `remove_teams` string[], required

## Response `202`

Successful Response

- CreateForecastWhatIfRunResponse
  - `run_id` string, uuid4, required
  - `status` 'queued' | 'running' | 'done' | 'failed', required

## Other responses

- `422`: Validation Error

## Changes

> 42 revisions in range; 2 not diffed.

- **2026-11-11** `8f6052380bd8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/tokenomics/v1/forecast-what-if-runs/post.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/8f6052380bd8?raw)