Skip to main content
POST
/
core
/
virtual
/
create-and-start
Create, approve, and start virtual device(s)
curl --request POST \
  --url https://acusight.io/api/core/virtual/create-and-start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "count": 123,
  "dataset_format": "<string>",
  "dataset_path": "<string>",
  "dataset_version_id": 123,
  "device_id_prefix": "<string>",
  "event_frequency": 123,
  "event_types": "<string>",
  "max_concurrent_tracks": 123,
  "preset": "<string>",
  "simulation_mode": "<string>"
}
'
{}

Authorizations

Authorization
string
header
required

JWT access token. Paste the token only; the Bearer prefix is added automatically.

Body

application/json

Virtual devices configuration

count
integer

Number of devices to create (default: 1, max: 50)

dataset_format
string

Dataset format: "yolo" (default), "coco", "voc"

dataset_path
string

Path to YOLO dataset (for image/hybrid modes, filesystem-based)

dataset_version_id
integer

ID of imported dataset version (for image/hybrid modes)

device_id_prefix
string

Prefix for device IDs (default: "virtual-dev")

event_frequency
integer

Seconds between new tracks (default: 5)

event_types
string

Custom event types JSON (overrides preset)

max_concurrent_tracks
integer

Max simultaneous tracks (default: 3)

preset
string

Event type preset (e.g., "general_manufacturing", "manufacturing_safety")

simulation_mode
string

Simulation mode: "event" (default), "image", or "hybrid"

Response

Devices created and started successfully

The response is of type object.