---
title: "Add Digital Humans To Simulation"
method: POST
path: "/v1/simulation/{simulation_id}/add-digital-humans"
tags: ["Simulations"]
---

# Add Digital Humans To Simulation

`POST /v1/simulation/{simulation_id}/add-digital-humans`

add existing digital humans to a simulation without replacing existing associations.

## Path parameters

- `simulation_id` integer, required

## Headers

- `X-API-Key` string, required

## Request body

- AddDigitalHumansToSimulationRequest — request body for adding existing digital humans to a simulation.
  - `digital_human_ids` integer[], required — array of existing digital human IDs to add to the simulation

## Response `200`

Successful Response

- AddDigitalHumansToSimulationResponse — response body for adding digital humans to a simulation.
  - `message` string, required — success or partial_success message
  - `failed_sip_reconcile_ids` integer[] — digital human ids linked to the simulation but whose always-on SIP reconcile failed; they are active but currently unroutable

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `a52d6f90f25a` — 1 info
  - added the optional property `failed_sip_reconcile_ids` to the response with the `200` status

[Change history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/simulation/:simulation_id/add-digital-humans/post.md)

---

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