Notes: Document Versions

These endpoints manage the version history of individual documents inside a notebook. Use them to list historical snapshots, fetch the content of a specific revision, capture a new snapshot of the current document, restore a previous revision, or permanently delete a stored version.

All endpoints are scoped to the notebook (notebookId) and the specific document node (nodeId) whose version history you want to work with.

---

GET /api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions

Lists all versions for a document, ordered by revision descending. Supports pagination via limit and offset query parameters.

Parameters

Name	In	Type	Required	Description
notebookId	path	string	Yes	Identifier of the notebook that owns the document
nodeId	path	string	Yes	Identifier of the document node whose versions are being listed
limit	query	integer	No	Maximum number of versions to return. Default: 20
offset	query	integer	No	Number of versions to skip from the start of the result set. Default: 0

Response

200

{
  "versions": [
    {
      "id": "v-9a8b7c6d5e4f",
      "documentId": "nd-5e8f2a1b3c7d",
      "revision": 7,
      "createdAt": "2026-01-14T09:42:11.000Z",
      "createdBy": "user-2c4a8b1e6f9d"
    },
    {
      "id": "v-3d2e1c0b9a87",
      "documentId": "nd-5e8f2a1b3c7d",
      "revision": 6,
      "createdAt": "2026-01-13T17:05:48.000Z",
      "createdBy": "user-2c4a8b1e6f9d"
    }
  ],
  "total": 2
}

403

{
  "message": "Forbidden",
  "code": "forbidden",
  "details": [
    {
      "path": "notebookId",
      "message": "You do not have access to this notebook"
    }
  ]
}

404

{
  "message": "Not Found",
  "code": "not_found",
  "details": [
    {
      "path": "nodeId",
      "message": "Document node does not exist"
    }
  ]
}

SDK Usage

await client.notes.versions.list("nb-7f3a2b9c1d4e", "nd-5e8f2a1b3c7d", { limit: 20, offset: 0 })

cURL

curl -X GET "https://proj-abc123-cont-xyz789-notes-1.us-east-1.containers.hoody.icu/api/v1/notes/notebooks/nb-7f3a2b9c1d4e/nodes/nd-5e8f2a1b3c7d/versions?limit=20&offset=0" \
  -H "Authorization: Bearer <token>"

---

GET /api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions/{versionId}

Retrieves a specific document version by ID, including the snapshot’s full content payload.

Parameters

Name	In	Type	Required	Description
notebookId	path	string	Yes	Identifier of the notebook that owns the document
nodeId	path	string	Yes	Identifier of the document node
versionId	path	string	Yes	Identifier of the specific version to retrieve

Response

200

{
  "id": "v-9a8b7c6d5e4f",
  "documentId": "nd-5e8f2a1b3c7d",
  "revision": 7,
  "content": {
    "type": "doc",
    "content": [
      {
        "type": "paragraph",
        "text": "Quarterly planning notes."
      }
    ]
  },
  "createdAt": "2026-01-14T09:42:11.000Z",
  "createdBy": "user-2c4a8b1e6f9d"
}

403

{
  "message": "Forbidden",
  "code": "forbidden",
  "details": [
    {
      "path": "notebookId",
      "message": "You do not have access to this notebook"
    }
  ]
}

404

{
  "message": "Not Found",
  "code": "not_found",
  "details": [
    {
      "path": "versionId",
      "message": "Version does not exist for this document"
    }
  ]
}

SDK Usage

await client.notes.versions.get("nb-7f3a2b9c1d4e", "nd-5e8f2a1b3c7d", "v-9a8b7c6d5e4f")

cURL

curl -X GET "https://proj-abc123-cont-xyz789-notes-1.us-east-1.containers.hoody.icu/api/v1/notes/notebooks/nb-7f3a2b9c1d4e/nodes/nd-5e8f2a1b3c7d/versions/v-9a8b7c6d5e4f" \
  -H "Authorization: Bearer <token>"

---

POST /api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions

Captures the current document content as a new version snapshot. The request takes no body; the snapshot is built from the document’s live state.

Parameters

Name	In	Type	Required	Description
notebookId	path	string	Yes	Identifier of the notebook that owns the document
nodeId	path	string	Yes	Identifier of the document node to snapshot

Response

200

{
  "id": "v-1b2c3d4e5f60",
  "documentId": "nd-5e8f2a1b3c7d",
  "revision": 8,
  "createdAt": "2026-01-15T11:22:03.000Z",
  "createdBy": "user-2c4a8b1e6f9d"
}

403

{
  "message": "Forbidden",
  "code": "forbidden",
  "details": [
    {
      "path": "notebookId",
      "message": "You do not have access to this notebook"
    }
  ]
}

404

{
  "message": "Not Found",
  "code": "not_found",
  "details": [
    {
      "path": "nodeId",
      "message": "Document node does not exist"
    }
  ]
}

SDK Usage

await client.notes.versions.create("nb-7f3a2b9c1d4e", "nd-5e8f2a1b3c7d")

cURL

curl -X POST "https://proj-abc123-cont-xyz789-notes-1.us-east-1.containers.hoody.icu/api/v1/notes/notebooks/nb-7f3a2b9c1d4e/nodes/nd-5e8f2a1b3c7d/versions" \
  -H "Authorization: Bearer <token>"

---

POST /api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions/{versionId}/restore

Restores a document to a previous version by replacing its current content with the snapshot stored at versionId. The request takes no body.

Caution

Restoring overwrites the document’s current content. The previous live state is not automatically snapshotted before restore; if you need to preserve it, call POST /api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions first.

Parameters

Name	In	Type	Required	Description
notebookId	path	string	Yes	Identifier of the notebook that owns the document
nodeId	path	string	Yes	Identifier of the document node being restored
versionId	path	string	Yes	Identifier of the version whose content should become the live document

Response

200

{
  "success": true
}

403

{
  "message": "Forbidden",
  "code": "forbidden",
  "details": [
    {
      "path": "notebookId",
      "message": "You do not have access to this notebook"
    }
  ]
}

404

{
  "message": "Not Found",
  "code": "not_found",
  "details": [
    {
      "path": "versionId",
      "message": "Version does not exist for this document"
    }
  ]
}

500

{
  "message": "Internal Server Error",
  "code": "internal_error",
  "details": [
    {
      "path": "nodeId",
      "message": "Failed to write restored content to the document"
    }
  ]
}

SDK Usage

await client.notes.versions.restore("nb-7f3a2b9c1d4e", "nd-5e8f2a1b3c7d", "v-9a8b7c6d5e4f")

cURL

curl -X POST "https://proj-abc123-cont-xyz789-notes-1.us-east-1.containers.hoody.icu/api/v1/notes/notebooks/nb-7f3a2b9c1d4e/nodes/nd-5e8f2a1b3c7d/versions/v-9a8b7c6d5e4f/restore" \
  -H "Authorization: Bearer <token>"

---

DELETE /api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions/{versionId}

Deletes a specific document version. The version is removed permanently from the version history.

Parameters

Name	In	Type	Required	Description
notebookId	path	string	Yes	Identifier of the notebook that owns the document
nodeId	path	string	Yes	Identifier of the document node
versionId	path	string	Yes	Identifier of the version to delete

Response

200

{
  "success": true
}

403

{
  "message": "Forbidden",
  "code": "forbidden",
  "details": [
    {
      "path": "notebookId",
      "message": "You do not have access to this notebook"
    }
  ]
}

404

{
  "message": "Not Found",
  "code": "not_found",
  "details": [
    {
      "path": "versionId",
      "message": "Version does not exist for this document"
    }
  ]
}

SDK Usage

await client.notes.versions.delete("nb-7f3a2b9c1d4e", "nd-5e8f2a1b3c7d", "v-9a8b7c6d5e4f")

cURL

curl -X DELETE "https://proj-abc123-cont-xyz789-notes-1.us-east-1.containers.hoody.icu/api/v1/notes/notebooks/nb-7f3a2b9c1d4e/nodes/nd-5e8f2a1b3c7d/versions/v-9a8b7c6d5e4f" \
  -H "Authorization: Bearer <token>"