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

# List Notes

Retrieve all notes accessible by the authenticated user with read permission.

## Authorization

Requires user permission `features.notes` or admin role.

## Query Parameters

<ParamField query="page" type="integer" optional>
  Page number for pagination. When provided, returns 60 notes per page.
</ParamField>

## Response

Returns an array of note objects with truncated content (max 1000 characters).

<ResponseField name="id" type="string" required>
  Unique identifier for the note
</ResponseField>

<ResponseField name="title" type="string" required>
  Title of the note
</ResponseField>

<ResponseField name="data" type="object" optional>
  Note content data with truncated markdown

  <Expandable title="properties">
    <ResponseField name="content.md" type="string">
      Markdown content (truncated to 1000 characters)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="updated_at" type="integer" required>
  Unix timestamp of last update
</ResponseField>

<ResponseField name="created_at" type="integer" required>
  Unix timestamp of creation
</ResponseField>

<ResponseField name="user" type="object" optional>
  User information of the note creator

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      User ID
    </ResponseField>

    <ResponseField name="name" type="string">
      User display name
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://your-domain.com/api/notes?page=1" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "note_abc123",
      "title": "Meeting Notes",
      "data": {
        "content": {
          "md": "# Meeting Summary\n\nDiscussed project roadmap..."
        }
      },
      "updated_at": 1709395200,
      "created_at": 1709308800,
      "user": {
        "id": "user_123",
        "name": "John Doe"
      }
    }
  ]
  ```

  ```json 401 Unauthorized theme={null}
  {
    "detail": "Unauthorized"
  }
  ```
</ResponseExample>

## Access Control

* Users must have `features.notes` permission enabled
* Returns only notes where the user has read access
* Admin users bypass permission checks with `BYPASS_ADMIN_ACCESS_CONTROL`
* Group-based access control is applied automatically