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
      • GETGet mind by ID
      • PUTUpdate mind by ID
      • DELDelete mind by ID
      • POSTRun simulation
      • GETGet signed URL for artifact upload
      • GETGet memory bank snapshots
      • POSTCreate a memory bank snapshot
      • GETGet memory bank snapshot status
      • GETGet all tags
      • PUTUpdate a tag
      • DELDelete a tag
      • PUTSet tags for a mind
      • GETList simulations
      • GETGet a simulation
      • DELDelete a simulation
      • GETGet psychometrics for a snapshot
      • GETGet topic analysis for a snapshot
      • GETGet snapshot details
      • POSTCreate a snapshot link
      • DELDelete a snapshot
      • POSTLink a snapshot
      • POSTUnlink a snapshot
      • GETGet API Key Usage
      • POSTProxy a request
    • Error Handling
  • SDKs
  • Core Concepts
    • Minds, Snapshots, & Simulations
    • SOC 2, HIPAA, & GDPR
LogoLogo
LogoLogo
Direct APIAPI Reference

Run simulation

POST
https://api.reasoner.com/api/mindsim/simulate
POST
/api/mindsim/simulate
$curl -X POST https://api.reasoner.com/api/mindsim/simulate \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{
> "scenario": {
> "message": "What would be your response to this customer complaint?"
> },
> "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
mindIdstringRequiredformat: "uuid"
conversationIdstringOptionalformat: "uuid"
Optional conversation ID to continue an existing conversation. If not provided, a new conversation will be created.
streambooleanOptional
Whether to stream the response. Defaults to false.
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