List notes in a folder by id (metadata only)

GET

/folders/by-id/{id}/notes

curl --request GET \
  --url https://api.engram.page/folders/by-id/example/notes \
  --header 'Authorization: Bearer <token>'

• Production

Returns metadata (no content) for the notes in the folder identified by its marker UUID. Returns 400 for a malformed UUID and 404 when no such folder exists.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Folder UUID

Responses

200

Folder notes

Media typeapplication/json

FolderNotesResponse

object

notes

required

Array<object>

NoteMeta

object

content_hash

string

nullable

folder

string

nullable

id

string format: uuid

nullable

mtime

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

tags

Array<string>

title

string

nullable

updated_at

string format: date-time

nullable

version

integer

nullable

Example

{
  "notes": [
    {
      "parse_status": "ok"
    }
  ]
}

400

Invalid UUID

Media typeapplication/json

Error

object

errors

One of:

string

string

object

object

Example^generated

{
  "errors": {}
}

404

No such folder

Media typeapplication/json

Error

object

errors

One of:

string

string

object

object

Example^generated

{
  "errors": {}
}