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/notesPOST
Create a note for the API-key owner. Bri derives a unique slug from the title and returns the new note identifiers.
Authorization
bearerAuth *Bearer <token>
Send the full key as Authorization: Bearer bri_..... Token in: header
Request Bodyapplication/jsonrequired
title *string
Min length: 1Max length: 120
content *string
Markdown body. Whitespace-only content is rejected.
Min length: 1
visibility?"public" | "private"
Default: "public"
expiresInDays?numbernull
Set to null for no expiration. Values above 30 are capped.
Default: 30Min: 1Max: 30
Response
201 · Note created.
data *object
Show properties
id *string
username *string
slug *string
title *string
400 · The request body or parameter is invalid.
error *string
Human-readable error message.
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 POST "https://bri.fyi/api/notes" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "title": "string", "content": "string", "visibility": "public", "expiresInDays": 30 }'