---
title: "Execute Scenario"
method: POST
path: "/api/prd/scenarios/{scenario_id}/execute"
tags: ["PRD Scenarios"]
---

# Execute Scenario

`POST /api/prd/scenarios/{scenario_id}/execute`

## Request

- Base URL: `https://api.getsigvest.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getsigvest.com/api/prd/scenarios/{scenario_id}/execute`
- Auth: OAuth 2 (password, token URL `api/auth/login`)

POST /api/prd/scenarios/{scenario_id}/execute
Execute a PRD scenario with user's portfolio

Requires: Active subscription or trial

## Path parameters

- `scenario_id` string, required

## Request body

- RunScenarioRequest
  - `portfolio_assets` PortfolioAsset[], required
    - `ticker` string, required
    - `quantity` number, required
    - `purchase_price` number, required
    - `current_price` number, nullable
  - `user_query` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getsigvest/apis/sigvest-api.md) · [All operations](https://skmtc.dev/getsigvest/apis/sigvest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getsigvest/apis/sigvest-api/revisions/3c011b033f7a?raw)