---
title: "Create a new role-play session"
method: POST
path: "/api/v1/role-play-sessions"
tags: ["role-play-session"]
---

# Create a new role-play session

`POST /api/v1/role-play-sessions`

## Request body

- RolePlaySessionCreateRequestDTO
  - `missionId` string, required — MissionId defined by CMS.
  - `overrideLanguage` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'zh' | 'ja' | 'id' | 'tr' | 'pt' | 'el' | 'ko' | 'vi' | 'hi' | 'ms' | 'th' | 'hr' | 'ro' | 'bg' | 'sv' | 'no' | 'yue' — Optional language override for the conversation. If not provided, defaults to the mission language.

## Response `201`

- RolePlaySessionCreateResponseDTO
  - `analysis` object, required
    - `createdAt` string, date-time, required
    - `id` string, required
    - `items` object[], required
      - `behaviours` object[] — Array of behaviours assessed for this item
        - `evidence` string[], required — Evidence supporting the behaviour assessment
        - `score` number, required — The numerical score for this behaviour
        - `verdict` string, required — The verdict of the behaviour evaluation
      - `conversationItemReferenceId` string, nullable — Reference ID to the conversation item
      - `createdAt` string, date-time, required — The date and time when the item was created
      - `explanation` string, nullable — Explanation of the analysis result
      - `id` string, required — The unique identifier for the analysis item
      - `lastUpdatedAt` string, date-time, required — The date and time when the item was last updated
      - `name` string, nullable — The name of the analysis item
      - `score` number, required — The numerical score for this analysis item
      - `solved` 'undetected' | 'notSolved' | 'partlySolved' | 'solved' | 'null', nullable — The solving status of the item
      - `state` 'PROCESSING' | 'DONE' | 'ERROR', required — The current state of the analysis item
      - `suggestion` string, nullable — Suggestions for improvement
    - `lastUpdatedAt` string, date-time, required
    - `score` number, required
    - `state` 'PENDING' | 'PROCESSING' | 'DONE' | 'SKIPPED', required
  - `call` object, required
    - `assistantReferenceId` string, required — The reference ID for the assistant
    - `createdAt` string, date-time, required — The date and time when the call was created
    - `endedReason` string, nullable — The reason why the call ended
    - `id` string, required — The unique identifier for the call
    - `lastUpdatedAt` string, date-time, required — The date and time when the call was last updated
    - `providerCallId` string, nullable — The provider call identifier
    - `state` 'PENDING' | 'DONE' | 'DATA-NOT-AVAILABLE' | 'CAN-NOT-PROCESS-TRANSCRIPT', required — The current state of the call
    - `summary` string, nullable — A summary of the call
    - `transcript` string, nullable — The transcribed conversation text
  - `completed` boolean, required
  - `createdAt` string, date-time, required
  - `id` string, required
  - `kpis` object, required
    - `createdAt` string, date-time, required
    - `id` string, required
    - `lastUpdatedAt` string, date-time, required
    - `listenRatio` number, nullable
    - `longestMonologue` number, nullable
    - `state` 'PENDING' | 'PROCESSING' | 'DONE' | 'SKIPPED', required
    - `talkSpeed` number, nullable
  - `language` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'zh-Hans', required
  - `lastUpdatedAt` string, date-time, required
  - `missionReferenceId` string, nullable — Reference ID for the associated mission
  - `missionTitle` string, nullable
  - `playedLanguage` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'zh' | 'ja' | 'id' | 'tr' | 'pt' | 'el' | 'ko' | 'vi' | 'hi' | 'ms' | 'th' | 'hr' | 'ro' | 'bg' | 'sv' | 'no' | 'yue' | 'null', nullable
  - `scorecardReferenceId` string, nullable — Reference ID for the associated scorecard
  - `scorecardTitle` string, nullable — Title of the associated scorecard
  - `state` 'PENDING' | 'PROCESSING' | 'DONE', required
  - `trackId` string, nullable — Parent track id for mission-backed roleplay sessions
  - `trackTitle` string, nullable
  - `type` 'ROLE_PLAY', required
  - `userId` string, required

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)