---
title: Notes
description: Free-text context attached to transactions.
canonical: https://bennybooks.com/developers/api/notes
markdown: https://bennybooks.com/developers/api/notes.md
---
# Notes

Free-text context attached to transactions.

> **Documentation index.** Fetch [https://bennybooks.com/developers/llms.txt](https://bennybooks.com/developers/llms.txt) before browsing further. Prefer markdown (this file or `Accept: text/markdown`). Site-wide map: [https://bennybooks.com/llms.txt](https://bennybooks.com/llms.txt).

### `GET https://bennybooks.com/api/v1/notes`

Notes attached to a transaction.

- operationId: `list_notes`
- scope: `read`

**Parameters**

- `transactionId` (uuid, required) — Transaction ID

**Response**

```json
{ "data": [ { "id": "…", "content": "…", "createdAt": "…" } ] }
```

### `POST https://bennybooks.com/api/v1/notes`

Create a proposal to attach a note. Approval required.

- operationId: `attach_note`
- scope: `propose-write`

**Body**

```json
{ "transactionId": "uuid", "content": "Client project: ACME-42" }
```

**Response**

```json
{ "data": { "id": "…", "status": "pending", "type": "note", … } }
```

### `PUT https://bennybooks.com/api/v1/notes`

Directly create a note without approval. For trusted automation only.

- operationId: `create_note`
- scope: `propose-write`

**Body**

```json
{ "transactionId": "uuid", "content": "Client project: ACME-42" }
```

**Response**

```json
{ "data": { "id": "…", "content": "…", "createdAt": "…" } }
```

> POST creates a proposal (approval required). PUT creates directly — use only for trusted automation.

---

## Machine-readable

- HTML: https://bennybooks.com/developers/api/notes
- Markdown: https://bennybooks.com/developers/api/notes.md
- Docs index: https://bennybooks.com/developers/llms.txt
- OpenAPI: https://bennybooks.com/openapi.json
- Skill: https://bennybooks.com/skill.md
- Auth: https://bennybooks.com/auth.md

```json
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Notes",
  "description": "Free-text context attached to transactions.",
  "url": "https://bennybooks.com/developers/api/notes",
  "inLanguage": "en",
  "encodingFormat": [
    "text/html",
    "text/markdown"
  ],
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "BennyBooks",
    "url": "https://bennybooks.com",
    "logo": {
      "@type": "ImageObject",
      "url": "https://bennybooks.com/apple-icon.png"
    }
  },
  "mainEntityOfPage": "https://bennybooks.com/developers/api/notes",
  "image": "https://bennybooks.com/opengraph-image",
  "workExample": {
    "@type": "CreativeWork",
    "url": "https://bennybooks.com/developers/api/notes.md",
    "encodingFormat": "text/markdown",
    "name": "Notes (Markdown)"
  },
  "about": {
    "@type": "WebAPI",
    "name": "BennyBooks Agent API",
    "url": "https://bennybooks.com/api/v1",
    "documentation": "https://bennybooks.com/developers"
  }
}
```
