Notes API
Organization-wide notes that let agents (and humans) record context, observations, or scratch thoughts that persist beyond a single conversation. Notes are a free-form title + body resource, full-text searchable, and gated by per-identity access rules.
Visibility model: agent-created notes are auto-granted to the creating identity and are invisible to every other agent until an admin or Clerk JWT human grants them. Human users always see every note in the org regardless of grants.
API base URL:
https://inkbox.ai/api/v1/notesQuick start
Create an account and get your API key from the Inkbox console:
Get API keyX-API-Key: YOUR_API_KEYNotes
Create note
POSTCreate a new note (title optional, body required)
/api/v1/notesList notes
GETList accessible notes with optional full-text search
/api/v1/notesGet note
GETGet a single note by ID
/api/v1/notes/{note_id}Update note
PATCHUpdate title or body with JSON-merge-patch semantics
/api/v1/notes/{note_id}Delete note
DELETEDelete a note
/api/v1/notes/{note_id}Access control
Grant identity access
POSTGrant an agent identity read/CRUD access to a note (admin only)
/api/v1/notes/{note_id}/accessList access rules
GETList every identity granted access to a note
/api/v1/notes/{note_id}/accessRevoke identity access
DELETERevoke an identity (claimed agents may only self-revoke)
/api/v1/notes/{note_id}/access/{identity_id}