---
title: "Update Simulation Result"
method: POST
path: "/v1/update-simulation-result"
tags: ["Simulation Results"]
---

# Update Simulation Result

`POST /v1/update-simulation-result`

## Headers

- `X-API-Key` string, required

## Request body

- SrcApiUpdateSimulationResultUpdateSimulationRequest
  - `simulation_result_id` string, required — Simulation result ID provided via SIP for the specific call
  - `events` Event[], nullable — List of events that occurred during the call
    - `title` string, required — Title of the event
    - `start_offset_ms` integer, required — Start offset of the event in milliseconds
    - `description` string, nullable — Description of the event
    - `end_offset_ms` integer, nullable — End offset of the event in milliseconds
    - `tags` string[], nullable — List of tags associated with the event
    - `metadata` object, nullable — Additional metadata associated with the event
  - `tool_calls` ToolCallData[], nullable — List of tool calls made during the call
    - `name` string, required
    - `start_offset_ms` integer, required
    - `description` string, nullable
    - `parameters` object, nullable
    - `output` unknown
  - `recorded_transcript` TranscriptEntryRequest[], nullable — Recorded transcript of the call (utilized to analyze STT accuracy)
    - `start_offset_ms` integer, required — Start offset of the utterance in milliseconds
    - `end_offset_ms` integer, required — End offset of the utterance in milliseconds
    - `speaker` 'AGENT' | 'USER' | 'DIGITAL_HUMAN' | 'agent' | 'digital_human', required — Role of a participant in a call or simulated conversation.
    - `utterance` string, required — Transcribed text of the utterance
    - `filler_utterance` boolean, nullable — Whether the utterance is a filler utterance
  - `tags` string[], nullable — List of tags associated with the call
  - `metadata` object, nullable — Additional metadata associated with the call
  - `trace_ids` string[], nullable — Trace IDs to associate with this simulation result

## Response `200`

Successful Response

- UpdateSimulationResponse
  - `status` string — Status of the response
  - `message` string, nullable — Optional message providing additional information about the response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/18bc44e35414/schema)