# Starts a new simulation session. Creates a new simulation session for the specified task. This includes: - Ensuring the AI tutor configuration exists - Initializing the conversation context with system prompts - Creating a unique conversation ID for the session The API user acts on behalf of the end-user and must have appropriate access to the task. Endpoint: POST /simulation/start Version: 0.9.0 Security: bearerAuth ## Request fields (application/json): - `simulationTask` (object, required) Simulation task. - `simulationTask.id` (string, required) The task ID. This field should contain the task identifier used in the client's system. - `simulationTask.type` (string, required) Defines the type of the task. Can be used by deserialization tools to instantiate the correct sub-type. Enum: "FREEFORM_TEXT", "IN_TEXT_FILL_IN_BLANKS", "IN_TEXT_CHOICES", "MULTIPLE_CHOICE", "MULTIPLE_RESPONSES", "SIMULATION" - `simulationTask.language` (string) The task language. Enum: "DE_CH", "DE_DE", "EN_US", "EN_UK", "FR_FR", "IT_IT", "ES_ES" - `simulationTask.title` (string) The task title. If left blank, the taskDefinition.id will be used as the title during implicit task creation or update. Example: "my_task_title" - `simulationTask.problemStatement` (string, required) The problem statement of the task. Example: "When was the Battle of Waterloo?" - `simulationTask.sampleSolution` (string) - `simulationTask.scenarioDescription` (string) - `simulationTask.initialMessage` (string) - `simulationTask.timeLimitInMinutes` (integer) - `tenantId` (string, required) The ID of the tenant the simulation is associated with. Example: "tenant_123" ## Response 200 fields (application/json): - `id` (string, required) Unique identifier of the simulation session. - `taskId` (string, required) The task ID associated with this simulation session. - `userId` (integer, required) The user ID who started the simulation session. - `transactionId` (integer) The transaction ID associated with this simulation session, if available. - `tutorId` (string, required) The ID of the tutor that provides the tutor interactions. - `initialMessages` (object, required) Conversation data for simulation tasks. - `initialMessages.messages` (array) - `initialMessages.messages.content` (string) - `initialMessages.messages.role` (string) Enum: "user", "assistant", "system"