For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Workflows
    • Overview
  • Get Started
    • MCP Quick Start
    • API Quick Start
  • MCP Server
    • Overview
    • Installation
  • Direct API
    • Overview
    • Authentication
      • GETGet all minds
      • POSTCreate a new mind
      • GETSearch minds
      • POSTRun simulation
      • GETGet signed URL for artifact upload
      • POSTCreate a memory bank snapshot
      • GETGet memory bank snapshot status
    • Error Handling
  • Core Concepts
    • Minds, Snapshots, & Simulations
    • SOC 2, HIPAA, & GDPR
LogoLogo
LogoLogo
Direct APIAPI Reference

Run simulation

POST
https://app.mindreasoner.com/api/public/v1/simulate
POST
/api/public/v1/simulate
$curl -X POST https://app.mindreasoner.com/api/public/v1/simulate \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{
> "scenario": {
> "message": "What would be your response to this customer complaint?"
> },
> "selectedSimulationModel": "mind-reasoner-pro",
> "mindId": "123e4567-e89b-12d3-a456-426614174000"
>}'
1{
2 "message": "Simulation completed successfully"
3}
Execute a simulation scenario against a specified mind.
Was this page helpful?
Previous

Get signed URL for artifact upload

Next
Built with

Authentication

AuthorizationBearer

API key passed as Bearer token in Authorization header (e.g., “Authorization: Bearer YOUR_API_KEY”)

Request

This endpoint expects an object.
scenarioobjectRequired
selectedSimulationModelenumRequired
The AI model to use for simulation
Allowed values:
mindIdstringRequiredformat: "uuid"
digitalTwinIdstringOptionalformat: "uuid"
Optional digital twin ID. If not provided, the default digital twin will be used.
runInBackgroundbooleanOptional
Whether to run the simulation in the background. Defaults to false.

Response

Successful simulation
messagestring
Simulation response

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error