POST
/
api
/
v1
/
admin
/
simulation
/
lifecycle
/
{organization_id}
/
start
Start Simulation
curl --request POST \
  --url https://api.jobsim.work/api/v1/admin/simulation/lifecycle/{organization_id}/start \
  --header 'Authorization: Bearer <token>'
{
  "organization_id": "<string>",
  "_id": "<string>",
  "settings_schema_version": 3,
  "chatter_lambda": 45,
  "min_chatter_interval": 10,
  "storyline_check_interval": 15,
  "psychometric_recalc_interval_messages": 5,
  "simulation_speed": 10,
  "chatter_max_global_per_hour": 10,
  "chatter_max_per_channel_per_hour": 5,
  "chatter_agent_cooldown_minutes": 15,
  "chatter_daily_budget": 50,
  "chatter_context_messages": 8,
  "chatter_include_org_context": true,
  "chatter_only_when_users_active": true,
  "chatter_max_chain_length": 2,
  "chatter_chain_expiry_minutes": 30,
  "office_hours_start": 9,
  "office_hours_end": 17,
  "timezone": "UTC",
  "business_days": [
    "<string>"
  ],
  "outside_business_hours_message": "<string>",
  "weekend_message": "<string>",
  "instant_response_probability": 0.65,
  "dm_response_delay_max": 25,
  "channel_response_delay_max": 15,
  "office_hour_distribution": [
    [
      123,
      123,
      123
    ]
  ],
  "simulation_epoch_start": "2023-11-07T05:31:56Z",
  "time_compression_factor": 1,
  "chatter_enabled": true,
  "storyline_enabled": true,
  "auto_assign_tasks": true,
  "enable_mem0_memory": false,
  "enable_org_knowledge_rag": true,
  "quick_help_call_enabled": true,
  "quick_help_call_voice": "marin",
  "quick_help_call_persona": "<string>",
  "quick_help_call_model": "gpt-4o-realtime-preview",
  "internal_agent_channels": [
    "<string>"
  ],
  "onboarding_call_enabled": true,
  "onboarding_call_character_id": "<string>",
  "onboarding_call_trigger": "first_login",
  "onboarding_call_required": false,
  "onboarding_call_allow_skip": true,
  "onboarding_call_custom_instructions": "<string>",
  "onboarding_call_reset_policy": "manual",
  "task_first_assignment_delay_minutes": 5,
  "active_task_ids": [
    "<string>"
  ],
  "scenario_character_ids": {},
  "default_scenario_name": "<string>",
  "primary_agent_ids": [
    "<string>"
  ],
  "channel_template_character_mapping": {},
  "channel_preset_key": "<string>",
  "task_preset_key": "<string>",
  "safety_enabled": false,
  "require_manager_approval_for": [
    "<string>"
  ],
  "simulation_policy": {},
  "events": [
    {
      "event_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "event_type": "scheduled",
      "channels": [
        "<string>"
      ],
      "character_ids": [
        "<string>"
      ],
      "schedule_day": "<string>",
      "schedule_hour": 123,
      "probability_per_cycle": 0,
      "opener_template": "<string>",
      "is_active": true
    }
  ],
  "simulation_mode": "continuous",
  "simulation_duration_minutes": 123,
  "simulation_started_at": "2023-11-07T05:31:56Z",
  "simulation_ends_at": "2023-11-07T05:31:56Z",
  "simulation_status": "not_started",
  "simulation_paused_at": "2023-11-07T05:31:56Z",
  "simulation_remaining_minutes_at_pause": 123,
  "simulation_completion_message": "<string>",
  "milestones": [
    {}
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organization_id
string
required

Response

Successful Response

Per-organization simulation settings. Controls timing, timezone, and feature flags. All parameters are customizable per organization.

Key settings: chatter_lambda (background chatter rate), chatter_enabled, storyline_check_interval, simulation_speed. Chatter rate limits prevent overwhelming channels.

​
organization_id
string
required
​
_id
string | null
​
settings_schema_version
integer
default:3
​
chatter_lambda
number
default:45
​
min_chatter_interval
number
default:10
​
storyline_check_interval
number
default:15
​
psychometric_recalc_interval_messages
integer
default:5
​
simulation_speed
number
default:10
​
chatter_max_global_per_hour
integer
default:10
​
chatter_max_per_channel_per_hour
integer
default:5
​
chatter_agent_cooldown_minutes
integer
default:15
​
chatter_daily_budget
integer
default:50
​
chatter_context_messages
integer
default:8
​
chatter_include_org_context
boolean
default:true
​
chatter_only_when_users_active
boolean
default:true
​
chatter_max_chain_length
integer
default:2
​
chatter_chain_expiry_minutes
integer
default:30
​
office_hours_start
integer
default:9
​
office_hours_end
integer
default:17
​
timezone
string
default:UTC
​
business_days
string[]
​
outside_business_hours_message
string | null
​
weekend_message
string | null
​
instant_response_probability
number
default:0.65
​
dm_response_delay_max
number
default:25
​
channel_response_delay_max
number
default:15
​
office_hour_distribution
tuple[]
​
simulation_epoch_start
string<date-time> | null
​
time_compression_factor
number
default:1
​
chatter_enabled
boolean
default:true
​
storyline_enabled
boolean
default:true
​
auto_assign_tasks
boolean
default:true
​
enable_mem0_memory
boolean
default:false
​
enable_org_knowledge_rag
boolean
default:true
​
quick_help_call_enabled
boolean
default:true
​
quick_help_call_voice
string
default:marin
​
quick_help_call_persona
string | null
​
quick_help_call_model
string
default:gpt-4o-realtime-preview
​
internal_agent_channels
string[]
​
onboarding_call_enabled
boolean
default:true
​
onboarding_call_character_id
string | null
​
onboarding_call_trigger
string
default:first_login
​
onboarding_call_required
boolean
default:false
​
onboarding_call_allow_skip
boolean
default:true
​
onboarding_call_custom_instructions
string | null
​
onboarding_call_reset_policy
string
default:manual
​
task_first_assignment_delay_minutes
number
default:5
​
active_task_ids
string[] | null

Org admin controls which tasks run

​
scenario_character_ids
Scenario Character Ids · object

Maps task_id to character_id. Org admin controls termination/hire targets per org.

​
default_scenario_name
string | null

Used for channel message seeding

​
primary_agent_ids
string[] | null

Optional agent IDs to ensure exist on login/signup (requires configured simulation characters).

​
channel_template_character_mapping
Channel Template Character Mapping · object

Map template placeholder IDs to org character IDs for channel message seeding

​
channel_preset_key
string | null

Last applied or selected channel template preset key (e.g. general_office).

​
task_preset_key
string | null

Last applied or selected task template preset key (e.g. hr_workforce, sales_operations_execution).

​
safety_enabled
boolean
default:false
​
require_manager_approval_for
string[]
​
simulation_policy
Simulation Policy · object

Org-level unified simulation policy used by routing, context, tools, and approvals.

​
events
SimulationEvent · object[]
​
simulation_mode
string
default:continuous
​
simulation_duration_minutes
integer | null
​
simulation_started_at
string<date-time> | null
​
simulation_ends_at
string<date-time> | null
​
simulation_status
string
default:not_started
​
simulation_paused_at
string<date-time> | null
​
simulation_remaining_minutes_at_pause
number | null
​
simulation_completion_message
string | null
​
milestones
Milestones · object[]
​
created_at
string<date-time>
​
updated_at
string<date-time>