---
{
  "id": "platform.notebook.overview",
  "topic": "notebook",
  "title": "Personal Notebook overview, access, and creation flow",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Notebook is the personal Note container; actions expose authorized creation, import/export, discovery, updates, archive lifecycle, and guarded deletion.",
  "content": "A Notebook is the personal container for Notes. Each user has a system default notebook, and notebooks also carry ordering and archived state. `list_notebooks` returns only notebooks with an explicit authorization row for the executing Agent; it is not a list of every notebook the user owns. `includeArchived` may include archived containers. `get_notebook` returns metadata plus `noteCount`; an unauthorized ID is reported as not found so the action does not disclose whether it exists.\n\n`create_notebook` is limited by the owner plan’s `max_notebooks`. At the limit it returns `PERMISSION_DENIED` with reason `PLAN_LIMIT`; explain the quota and do not retry to force past it. A successful create automatically grants the executing Agent write access, so the returned `notebookId` can be passed directly to `create_note`. Notebook reads permit the public surface; create does not.\n\nWhen a request needs a Note but does not identify its Notebook, first call `list_notebooks`. If more than one suitable location remains, ask the user to choose; then call `create_note` with the selected `notebookId`. Do not guess a hidden or unauthorized container.\n\n`update_notebook` changes a name or sort order; `archive_notebook` and `unarchive_notebook` manage reversible state. `delete_notebook` requires UserConfirm with Strict drift, accepts only an owned, Agent-writable, archived, non-default personal notebook, and moves its Notes to the default. These mutations are unavailable on public surfaces.\n\n`import_notebook` converts an authorized File Center file. `export_notebook` saves an authorized Notebook as JSON, Markdown, or PDF to the triggering user's personal File Center and returns a `fileId` plus content path; it accepts no inline bytes. REST `/api/v1/notebooks/{id}/export` exposes start, poll, and download.\n",
  "aliases": [
    "notebook",
    "notebooks",
    "personal notebook",
    "note container",
    "list notebooks",
    "create notebook",
    "筆記本",
    "記事本"
  ],
  "tags": [
    "notebook",
    "overview",
    "permission",
    "quota",
    "note-container"
  ],
  "relatedActions": [
    "arinova.notebook.create_notebook",
    "arinova.notebook.import_notebook",
    "arinova.notebook.export_notebook",
    "arinova.notebook.list_notebooks",
    "arinova.notebook.get_notebook",
    "arinova.notebook.update_notebook",
    "arinova.notebook.archive_notebook",
    "arinova.notebook.unarchive_notebook",
    "arinova.notebook.delete_notebook",
    "arinova.note.create_note"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/en/kb/notebook/overview/"
}
---

A Notebook is the personal container for Notes. Each user has a system default notebook, and notebooks also carry ordering and archived state. `list_notebooks` returns only notebooks with an explicit authorization row for the executing Agent; it is not a list of every notebook the user owns. `includeArchived` may include archived containers. `get_notebook` returns metadata plus `noteCount`; an unauthorized ID is reported as not found so the action does not disclose whether it exists.

`create_notebook` is limited by the owner plan’s `max_notebooks`. At the limit it returns `PERMISSION_DENIED` with reason `PLAN_LIMIT`; explain the quota and do not retry to force past it. A successful create automatically grants the executing Agent write access, so the returned `notebookId` can be passed directly to `create_note`. Notebook reads permit the public surface; create does not.

When a request needs a Note but does not identify its Notebook, first call `list_notebooks`. If more than one suitable location remains, ask the user to choose; then call `create_note` with the selected `notebookId`. Do not guess a hidden or unauthorized container.

`update_notebook` changes a name or sort order; `archive_notebook` and `unarchive_notebook` manage reversible state. `delete_notebook` requires UserConfirm with Strict drift, accepts only an owned, Agent-writable, archived, non-default personal notebook, and moves its Notes to the default. These mutations are unavailable on public surfaces.

`import_notebook` converts an authorized File Center file. `export_notebook` saves an authorized Notebook as JSON, Markdown, or PDF to the triggering user's personal File Center and returns a `fileId` plus content path; it accepts no inline bytes. REST `/api/v1/notebooks/{id}/export` exposes start, poll, and download.