Inkbox

> # Documentation index
> Fetch the complete documentation index at: https://inkbox.ai/sitemap.xml
> Use this file to discover all available pages before exploring further.

---

# Notes API
description: Organization-wide notes for AI agents — full-text searchable, with per-identity access control

---


# 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:


## Quick start

Create an account and get your API key from the Inkbox console:

[Get API key](https://inkbox.ai/console/api-keys)


## Notes


  **[Create note](/docs/api/notes/manage)** `POST` `/api/v1/notes` — Create a new note (title optional, body required)

  **[List notes](/docs/api/notes/manage)** `GET` `/api/v1/notes` — List accessible notes with optional full-text search

  **[Get note](/docs/api/notes/manage)** `GET` `/api/v1/notes/{note_id}` — Get a single note by ID

  **[Update note](/docs/api/notes/manage)** `PATCH` `/api/v1/notes/{note_id}` — Update title or body with JSON-merge-patch semantics

  **[Delete note](/docs/api/notes/manage)** `DELETE` `/api/v1/notes/{note_id}` — Delete a note


## Access control


  **[Grant identity access](/docs/api/notes/access)** `POST` `/api/v1/notes/{note_id}/access` — Grant an agent identity read/CRUD access to a note (admin only)

  **[List access rules](/docs/api/notes/access)** `GET` `/api/v1/notes/{note_id}/access` — List every identity granted access to a note

  **[Revoke identity access](/docs/api/notes/access)** `DELETE` `/api/v1/notes/{note_id}/access/{identity_id}` — Revoke an identity (claimed agents may only self-revoke)


## Additional resources

- [Contacts API](/docs/api/contacts)
- [Mail API](/docs/api/mail)
- [Phone API](/docs/api/phone)