---
title: "List saved messages"
method: GET
path: "/savedmessages"
tags: ["Saved Messages"]
---

# List saved messages

`GET /savedmessages`

Lists all saved messages accessible to the organization. Returns both private and organization-wide saved messages with pagination support.

## Query parameters

- `pageSize` integer
- `paginationToken` string — Token given in a previous response to allow requesting the next page

## Response `200`

A paged array of saved messages

- object
  - `hasMore` boolean, required
  - `paginationToken` string — Token given in a previous response to allow requesting the next page
  - `savedMessages` SavedMessage[], required
    - `attachments` ConversationItemAttachment[], required
      - `data` union
        - ConversationItemAudioAttachment
          - `mimetype` string, required — The mimetype of the audio attachment.
          - `signedUrl` SignedUrl, required
            - `expiresAt` string, date-time, required — The date the signed URL expires.
            - `url` string, url, required — The signed URL.
          - `transcription` ConversationItemTranscription
            - `id` string, required — The id of the transcription job. Pass this to the [Transcription endpoint](/reference/transcription) to fetch the full transcription text.
            - `status` 'completed' | 'pending' | 'failed' | 'noSpeech', required — The current status of the transcription. When `pending`, the transcription is still being processed.
            - `summarizationStatus` 'completed' | 'pending' | 'failed' — The current status of the summarization, if the transcription is being summarized. Null when no summarization was requested.
        - ConversationItemDocumentAttachment
          - `mimetype` string, required — The mimetype of the document attachment.
          - `name` string, required — The name associated with the attached document.
          - `signedUrl` SignedUrl, required
            - `expiresAt` string, date-time, required — The date the signed URL expires.
            - `url` string, url, required — The signed URL.
        - ConversationItemEntityProfileAttachment
          - `title` string, required — The title associated with the attached entity profile.
          - `url` string, required — The URL of the entity profile.
        - ConversationItemImageAttachment
          - `mimetype` string, required — The mimetype of the image attachment.
          - `signedUrl` SignedUrl, required
            - `expiresAt` string, date-time, required — The date the signed URL expires.
            - `url` string, url, required — The signed URL.
        - ConversationItemVideoAttachment
          - `mimetype` string, required — The mimetype of the video attachment.
          - `signedUrl` SignedUrl, required
            - `expiresAt` string, date-time, required — The date the signed URL expires.
            - `url` string, url, required — The signed URL.
      - `title` string, required — The title of the attachment.
      - `type` 'audio' | 'carePlan' | 'document' | 'entityProfile' | 'genericUrl' | 'image' | 'paymentRequest' | 'video' | 'visit', required — The type of the attachment.
    - `createdAt` string, date-time, required
    - `creatorMemberId` string, required — The ID of the organization member who created this saved message
    - `id` string, required — Spruce's saved message ID
    - `internal` boolean, required — Whether this message is an internal note when used
    - `modifiedAt` string, date-time, required
    - `object` string, required — String representing the object's type
    - `shared` boolean, required — Whether this saved message is accessible to all members of the organization. If false, the saved message is private to the creator.
    - `text` string, required — Plain text content of the saved message
    - `title` string, required — User-defined title for the saved message

## Other responses

- `400` — bad request
- `500` — unexpected error

---

[API](https://skmtc.net/sprucehealth/apis/spruce-health-api.md) · [All operations](https://skmtc.net/sprucehealth/apis/spruce-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sprucehealth/spruce-health-api/versions/988e298cd9fd/schema)