---
title: "Run Simulation"
method: POST
path: "/api/simulator/run"
tags: ["simulator"]
---

# Run Simulation

`POST /api/simulator/run`

## Request

- Base URL: `https://www.gateco.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://www.gateco.ai/api/simulator/run`
- Auth: OAuth 2 (password, token URL `/api/auth/login`)

Dry-run policy evaluation for a principal against resources.

## Request body

- SimulationRequest: Request body for the dry-run simulation endpoint.
  - `principal_id` string, required
  - `query` string, nullable
  - `connector_id` string, nullable
  - `resource_ids` string[], nullable

## Response `200`

Successful Response

- SimulationResponse: Response from the dry-run simulation endpoint.
  - `outcome` string, required
  - `matched_resources` integer, required
  - `allowed` integer, required
  - `denied` integer, required
  - `policy_trace` object[], required
  - `denial_reasons` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gateco/apis/gateco-api.md) · [All operations](https://skmtc.dev/gateco/apis/gateco-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gateco/apis/gateco-api/revisions/5debaf204950?raw)