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

# Notes

> SDK reference for clinical note (DocumentReference) operations.

# clinik.notes

## create

```ts theme={null}
const { data, meta } = await clinik.notes.create(request: NoteCreateRequest): Promise<ApiResponse<DocumentReference>>
```

| Field             | Type                                 | Required | Description                           |
| ----------------- | ------------------------------------ | -------- | ------------------------------------- |
| `patientId`       | `string`                             | Yes      | Patient reference                     |
| `authorId`        | `string`                             | No       | Practitioner who authored the note    |
| `encounterId`     | `string`                             | No       | Encounter reference                   |
| `type`            | `NoteType`                           | No       | Type of clinical note                 |
| `title`           | `string`                             | Yes      | Note title                            |
| `content`         | `string`                             | Yes      | Note content (plain text or markdown) |
| `contentType`     | `string`                             | No       | MIME type (default: text/plain)       |
| `docStatus`       | `string`                             | No       | preliminary, final, amended           |
| `category`        | `string`                             | No       | Category tag                          |
| `date`            | `string`                             | No       | Clinically relevant date              |
| `relatesTo`       | `Array<{ code, targetId }>`          | No       | Relationships to other documents      |
| `securityLabel`   | `Array<{ system?, code, display? }>` | No       | Document security tags                |
| `authenticatorId` | `string`                             | No       | Who authenticated the document        |
| `custodianId`     | `string`                             | No       | Organization maintaining the document |
| `servicePeriod`   | `{ start?, end? }`                   | No       | Time period of service documented     |
| `facilityType`    | `string`                             | No       | Kind of facility                      |
| `practiceSetting` | `string`                             | No       | Clinical specialty                    |

### Note Types

| Type                   | Description       |
| ---------------------- | ----------------- |
| `progress-note`        | Progress note     |
| `discharge-summary`    | Discharge summary |
| `consultation-note`    | Consultation note |
| `history-and-physical` | H\&P              |
| `operative-note`       | Operative note    |
| `procedure-note`       | Procedure note    |
| `referral-note`        | Referral note     |
| `transfer-summary`     | Transfer summary  |
| `other`                | Other             |

### Relates To Codes

| Code         | Description                     |
| ------------ | ------------------------------- |
| `replaces`   | This note replaces the target   |
| `transforms` | This note transforms the target |
| `signs`      | This note signs the target      |
| `appends`    | This note appends to the target |

## search / read / update / delete

Same pattern as other resources.