Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.
/api/notesGET
List the authenticated owner's notes. Active reads best-effort expire due notes before returning; deleted reads include soft-deleted notes.
Authorization
bearerAuth *Bearer <token>
Send the full key as Authorization: Bearer bri_..... Token in: header
Query Parameters
state?"active" | "deleted"
Default: "active"
Response
200 · Notes in newest-first order.
data *object[]
Show item properties
id *string
Stable Convex note identifier.
username *string
slug *string
title *string
content *string
Markdown content.
visibility *"public" | "private"
state *"active" | "deleted"
createdAt *integer (int64)
Unix timestamp in milliseconds.
updatedAt *integer (int64)
Unix timestamp in milliseconds.
expiresAt *integer (int64) | null
deletedAt *integer (int64) | null
purgeAt *integer (int64) | null
401 · The bearer key is missing, malformed, revoked, or invalid.
error *string
Human-readable error message.
403 · The caller lacks the required permission or ownership.
error *string
Human-readable error message.
Request example
curl -X GET "https://bri.fyi/api/notes" \ -H "Authorization: Bearer <token>"