Personal Notebook overview, access, and creation flow

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.

Related actions

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

Also known as

notebook, notebooks, personal notebook, note container, list notebooks, create notebook, 筆記本, 記事本

---

Machine-readable Markdown · Knowledge index