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

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.

Successful simulation

messagestring

Simulation response

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

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