> ## Documentation Index
> Fetch the complete documentation index at: https://api.buildingswell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Note

> Notes on deliverables.

Notes on deliverables. Standard CRUD applies. See [standard endpoints](/guides/standard-endpoints).

## Fields

| Field            | Type   | Notes                                                                                           |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------- |
| `id`             | UUID   | Auto-generated                                                                                  |
| `organizationId` | UUID   | From API key                                                                                    |
| `deliverableId`  | UUID   | The deliverable this note belongs to                                                            |
| `content`        | object | Rich-text document (JSON object). **Must** be an object — a plain string is rejected with `400` |
| `createdAt`      | date   | Auto-generated                                                                                  |
| `updatedAt`      | date   | Auto-generated                                                                                  |

## Create or update by deliverable

Creates if missing, updates if it exists:

```http theme={null}
PUT /note/by-deliverable

{
  "deliverableId": "<uuid>",
  "content": { "type": "doc", "content": [] }
}
```