---
title: "Get a notebook"
method: GET
path: "/notebooks/{notebookId}"
tags: ["Notebooks"]
---

# Get a notebook

`GET /notebooks/{notebookId}`

## Path parameters

- `notebookId` string, required — Opaque notebook identifier.

## Response `200`

Notebook details

- object
  - `notebook` object, required
    - `id` string, required — Opaque notebook identifier.
    - `projectId` string, uuid, required
    - `name` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time
    - `isInit` boolean, required — Whether this notebook is the init notebook for the project, which can run as a prelude to other notebooks in it. Naming a notebook "Init" designates it.
    - `isScheduled` boolean, required — Whether this notebook is the scheduled notebook for the project.
    - `lastRunAt` string, date-time, nullable, required — When the notebook last ran, or null if it has not run yet.
    - `lastRunId` string, uuid, nullable, required — ID of the latest notebook run, or null if never run.
    - `inputs` NotebookInput[] — Input variables required to run the notebook, in notebook order. Present only when defined.
      - `blockId` string, required — Opaque block identifier.
      - `name` string, required — Variable name assigned by the input block.
      - `type` string, required — Input block type.
      - `value` union — Current value used when the notebook runs.
        - string
        - boolean
        - string[]
      - `label` string — Human-readable input label.
    - `blocks` BlockSummary[], required — Blocks in the notebook, in order.
      - `id` string, required — Opaque block identifier.
      - `type` string, required
      - `content` string

## Other responses

- `400` — Validation error or project is suspended
- `401` — Unauthorized
- `403` — Insufficient permissions
- `404` — Notebook not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/deepnote/apis/deepnote-public-api.md) · [All operations](https://skmtc.net/deepnote/apis/deepnote-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deepnote/deepnote-public-api/revisions/726970fd2992/schema)