---
title: "# Update Simulation"
method: PUT
path: "/v1/simulations/{Id}"
tags: ["Simulations"]
---

# # Update Simulation

`PUT /v1/simulations/{Id}`

Updates the simulation with given information

## Path parameters

- `Id` integer, required

## Request body

- object
  - `schedule` ScheduleInput
    - `day_of_month` integer[] — required if frequency is `MONTHLY`
    - `day_of_week` integer[] — required if frequency is `WEEKLY`
    - `frequency` string, required — ONCE, DAILY, WEEKLY, MONTHLY
    - `frequency_interval` integer — required if frequency is not `ONCE`
    - `name` string, required
    - `start_time` integer, required — time format -> `epoch` Optional value: `now`
  - `schedule_now` boolean

## Response `200`

SimulationUpdateReturnSwagger

- object
  - `run_immediately` boolean
  - `simulation` SimulationApiOutput
    - `agent_id` NullInt64
      - `Int64` integer
      - `Valid` boolean
    - `agent_user_ids` integer[] — agent user ids for installable agent execution users
    - `description` string — Simulation Description (description of the simulation)
    - `id` integer — Simulation Id (1)
    - `integrations` integer[] — Simulation Integrations ([1,2,3])
    - `is_active` NullBool
      - `Bool` boolean
      - `Valid` boolean
    - `name` string — Simulation Name (Simulation - 1)
    - `obfuscation_methods` string[] — obfuscation methods
    - `protocols` AssessmentProtocol[] — Simulation Protocols ([http, https]) protocols
      - `module_id` integer
      - `protocols` string[]
    - `schedule_id` integer — Simulation Schedule Id (3)
    - `template_id` NullInt64
      - `Int64` integer
      - `Valid` boolean

## Other responses

- `422` — validationErrorSwagger is represents the erroneous cases
- `default` — genericErrorSwagger is represents the erroneous cases

---

[API](https://skmtc.net/picussecurity/apis/picus-rest-api.md) · [All operations](https://skmtc.net/picussecurity/apis/picus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/picussecurity/picus-rest-api/versions/cb0d02ee28f8/schema)