Run simulation | Mind Reasoner API Documentation

Execute a simulation scenario against a specified mind.

AuthorizationBearer

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

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.

Successful simulation

messagestring

Simulation response

1	import requests
2
3	url = "https://app.mindreasoner.com/api/public/v1/simulate"
4
5	payload = {
6	"scenario": { "message": "What would be your response to this customer complaint?" },
7	"selectedSimulationModel": "mind-reasoner-pro",
8	"mindId": "123e4567-e89b-12d3-a456-426614174000"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"message": "Simulation completed successfully"
3	}