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/notes/by-id/{noteId}PATCH
Update, soft-delete, restore, or permanently delete an owned note. A normal update creates a version snapshot. The restore action in this route requires a signed-in Bri web session; API keys can use the version restore route.
Authorization
bearerAuth *Bearer <token>
Send the full key as Authorization: Bearer bri_..... Token in: header
Request Bodyapplication/jsonrequired
Response
200 · Mutation result.
data *object | object | object
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.
404 · The resource is not available to the caller.
error *string
Human-readable error message.
Request example
curl -X PATCH "https://bri.fyi/api/notes/by-id/<noteId>" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "action": "update", "title": "string", "content": "string", "visibility": "public", "expiresInDays": 30 }'