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

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

$	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"
>	}'

$	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"
>	}'