---
title: "POST /api/kernel/save"
method: POST
path: "/api/kernel/save"
---

# POST /api/kernel/save

`POST /api/kernel/save`

## Headers

- `Marimo-Session-Id` string, required

## Request body

- SaveNotebookRequest
  - `cellIds` CellId[], required
  - `codes` string[], required
  - `configs` CellConfig[], required
    - `column` integer, nullable
    - `disabled` boolean
    - `hide_code` boolean
  - `filename` string, required
  - `layout` object, nullable
  - `names` string[], required
  - `persist` boolean

## Response `200`

Save the current app

## Changes

> 60 revisions in range; 2 could not be searched.

- **2026-03-31** `41bba414df27` — 1 breaking
  - the `cellIds/items/` request property type/format changed from `string`/`` to `string`/`cell-id`
- **2026-03-18** `f29fa637d35b` — 1 info
  - the `cellIds/items/` request property type/format was generalized from `string`/`cell-id` to `string`/``

[Change history](https://skmtc.dev/marimo-team/apis/marimo-api/changes/api/kernel/save/post.md)

---

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