Skip to main content
POST
Write a note

Authorizations

Authorization
string
header
required

A workspace API key, created in workspace settings and sent as Authorization: Bearer op_live_…. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.

Body

application/json

What the note says, and what it is about.

subject
object
required

What to attach it to.

body
string
required

The note itself. Trimmed on write. Long enough for a real handover note, short enough that nobody pastes a transcript into a list view.

Required string length: 1 - 5000

Response

The note, as written.

A note on a signal, an account or a list. Workspace-visible, deliberately: a colleague who cannot see that somebody already called them will call again.

id
string
required

Stable identifier.

orgId
string
required

The workspace this belongs to (org_…).

subject
object
required

What the note is attached to.

body
string
required

The note, trimmed. Up to 5,000 characters.

authorId
string
required

Clerk user id of whoever wrote it.

createdAt
string<date-time>
required

When it was written.

updatedAt
string<date-time>
required

When the row last changed.

editedAt
string<date-time>

Set only when the body changed after it was first written.