Skip to content
Engram Docs

Get a note by path

GET
/notes/*path
curl --request GET \
  --url 'https://api.engram.page/notes/*path' \
  --header 'Authorization: Bearer <token>'

Returns the full note (including content) at the given slash-separated path, or 404 if no note exists there.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
path
required
string

Note path (slash-separated)

Responses

Section titled “Responses”

200

Section titled “200”

Note

Media typeapplication/json
Note
object
content
string
content_hash
string
nullable
description

OKF frontmatter description field

string
nullable
fm_created

OKF frontmatter created/date field

string format: date-time
nullable
fm_timestamp

OKF frontmatter timestamp/modified/updated field

string format: date-time
nullable
folder
string
nullable
id
string format: uuid
nullable
mtime

Client mtime (epoch seconds)

number format: float
parse_reason

Present when parse_status is “degraded”: {code, message, detail}

object
parse_status

Frontmatter parse outcome

string
nullable
Allowed values: ok degraded
path
required
string
resource

OKF frontmatter resource field

string
nullable
tags
Array<string>
title
string
nullable
type

OKF frontmatter type field

string
nullable
updated_at
string format: date-time
nullable
version
integer
nullable
Example
{
  "parse_status": "ok",
  "path": "Projects/engram.md"
}

404

Section titled “404”

No such note

Media typeapplication/json
Error
object
errors
One of:
string
Examplegenerated
{
  "errors": {}
}