---
title: "Assign a scorecard to a real call session"
method: PATCH
path: "/api/v1/real-call-sessions/{sessionId}"
tags: ["real-call-session"]
---

# Assign a scorecard to a real call session

`PATCH /api/v1/real-call-sessions/{sessionId}`

## Path parameters

- `sessionId` string, uuid, required

## Request body

- RealCallSessionPatchRequestDTO
  - `scorecardId` string, required — The scorecard ID to assign to the session.

## Response `201`

- RealCallSessionPatchResponseDTO
  - `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
  - `participantUserIds` string[], required — User IDs of all attributed speakers in the call, including the scored rep. Empty array when the transcript carries no speaker attribution.
  - `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` 'REAL_CALL', 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)