---
title: "Run one request against a hosted live simulation"
method: POST
path: "/api/v0/desk/runs/{run}/requests"
tags: ["Desk"]
---

# Run one request against a hosted live simulation

`POST /api/v0/desk/runs/{run}/requests`

## 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/runs/{run}/requests`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/desk/runs/:run/requests/post.ts> (a function with typed inputs; its response is checked against the schema)

Step, force, or query a simulation opened through ``sim_open``. A run that is not this user's, or whose worker is gone, answers the sidecar's own ``no such simulation session`` error.

## Path parameters

- `run` string, required

## Request body

- DeskRunRequestBody: One request against a running run: a ``sim_*`` step of a panel's simulation, or a board's ``board_set`` or a ``board_analysis`` at what it last settled.
  - `method` string, required
  - `params` object
  - `timeout_ms` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `07854361a13b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/desk/runs/:run/requests/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)