---
title: "Run one scenario against a draft"
method: POST
path: "/api/v0/desk/drafts/simulate"
tags: ["Desk"]
---

# Run one scenario against a draft

`POST /api/v0/desk/drafts/simulate`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/desk/drafts/simulate`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/desk/drafts/simulate/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- DraftSimulateRequest
  - `files` object, required: The draft's files, {path: text}, paths relative to the project root.
  - `scenario` string, required: One scenario: its TOML text, or the path among ``files`` of a scenario file. It names its drawing file among ``files``.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `ecd5b922e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/desk/drafts/simulate/post.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)