---
title: "Create a simulation board for a study"
method: POST
path: "/projects/{project_id}/studies/{study_id}/simulation_boards"
tags: ["simulation_boards"]
---

# Create a simulation board for a study

`POST /projects/{project_id}/studies/{study_id}/simulation_boards`

Create a new simulation board within a study.

## Path parameters

- `project_id` string, required
- `study_id` string, required

## Request body

- SimulationBoardCreatePayload
  - `name` string, required — The name of the simulation board.
  - `template_id` string, required — The experiment template this board is bound to.
  - `config` object — Visualization config (plots and grid layout).
  - `table_filter` object — Persisted MUI DataGrid filter model for this board.
  - `column_visibility` object, nullable — Persisted MUI DataGrid column visibility model for this board.

## Response `201`

Successful Response

- SimulationBoard
  - `name` string, required — The name of the simulation board.
  - `template_id` string, required — The experiment template this board is bound to.
  - `project_id` string, required — The project this simulation board belongs to.
  - `study_id` string, nullable — The study this simulation board belongs to, if any.
  - `organization_id` string, required — Organization this simulation board belongs to.
  - `config` object — Visualization config (plots and grid layout).
  - `table_filter` object — Persisted MUI DataGrid filter model for this board.
  - `column_visibility` object, nullable — Persisted MUI DataGrid column visibility model for this board.
  - `id` string, required — The unique identifier for the board.
  - `created_at` string, date-time, required — Timestamp of when the board was created.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)