Get Note Templates

curl --request GET \
  --url https://api.decodahealth.com/notes/templates \
  --header 'API-KEY: <api-key>' \
  --header 'TENANT: <tenant>'

[
  {
    "id": "<string>",
    "name": "<string>",
    "createdDate": "2023-11-07T05:31:56Z",
    "questions": [],
    "userIds": [
      "<string>"
    ],
    "isFavorited": false,
    "expiryDays": 123
  }
]

Notes

Get Note Templates

List all non-archived note templates.

IMPORTANT: This endpoint intentionally returns ALL templates regardless of user access. User-based filtering and sorting is handled on the frontend for the following reasons:

Admin visibility: Users with admin/management permissions (e.g., SETTINGS_NOTE_TEMPLATES_*) need to see all templates to manage access control, even templates they personally cannot use. The settings page (note-templates/page.tsx) displays all templates for this purpose.
Access control data: Each template includes a user_ids array indicating which users have access. The frontend uses this to filter templates appropriately based on context:
- Template selectors (SelectTemplateModal): Filter to only show templates the user can access
- Settings pages: Show all templates for management purposes
Favorites are user-specific: The is_favorited field reflects the current user’s preference and is used by the frontend to sort favorited templates first.

Frontend filtering logic (in useNoteTemplates hook):

Shows templates where user_ids is null/undefined (legacy: everyone has access)
Shows templates where user_ids includes the current user’s ID
Sorts favorited templates to the top, then alphabetically by name

GET

notes

templates

Get Note Templates

curl --request GET \
  --url https://api.decodahealth.com/notes/templates \
  --header 'API-KEY: <api-key>' \
  --header 'TENANT: <tenant>'

[
  {
    "id": "<string>",
    "name": "<string>",
    "createdDate": "2023-11-07T05:31:56Z",
    "questions": [],
    "userIds": [
      "<string>"
    ],
    "isFavorited": false,
    "expiryDays": 123
  }
]

Headers

TENANT

string

required

The tenant you are making this request on behalf of

API-KEY

string

required

Your api key

Response

200 - application/json

Successful Response

string

required

name

string

required

createdDate

string<date-time>

required

questions

NoteQuestionDetail · object[]

Show child attributes

userIds

string[] | null

isFavorited

boolean

default:false

expiryDays

integer | null

Get Note Template Detail Get Note Versions