BizKitHub
DocsAPI ReferenceAi Agent/bff/ai-context/update
postAi AgentAdmin BFF

/bff/ai-context/update

Replace title / content / pin of an existing note. content replaces the whole body, so read the note first, edit it, and send expectedVersion to avoid overwriting a colleague’s concurrent change.

AI AgentpostBffAi-contextUpdate

Parameters

JSON body

Request body

application/json
idstringRequired

Note id (16 characters), as returned by /list or shown in the /document markdown.

Length: 16–16
titlestringOptional

Short topic title, e.g. "Invoicing conventions" or "Warehouse and shipping".

Length: 1–160
contentstringOptional

Full new Markdown body (replaces the old one).

Length: 0–20000
isPinnedbooleanOptional
expectedVersionnumberOptional

Version you based your edit on. When it no longer matches, nothing is written and HTTP 409 is returned: re-read, merge, retry.

Response schema

1 status code documented

200Success
idstringRequired
versionnumberRequired

Response example

application/json
{
  "id": "example_id",
  "version": 0
}

Request example

POST /bff/ai-context/update

post
curl -X POST "https://api.bizkithub.com/bff/ai-context/update" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "id": "example_id",
  "title": "example_title",
  "content": "example_content",
  "isPinned": false,
  "expectedVersion": 0
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key