Brand Notebook

Client notes and meeting transcripts

List notebook entries

get

List client notes / meeting transcripts for a site. Requires Agency plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

siteIdstring · uuidRequired

Site ID

Query parameters

limitintegerOptionalDefault: 50

offsetintegerOptionalDefault: 0

sourcestringOptional

Filter by source (api, manual, etc.)

Responses

200

List of notebook entries

application/json

idstring · uuidOptional

titlestringOptional

contentstringOptional

meeting_datestring · date · nullableOptional

sourcestringOptional

processing_statusstring · enumOptionalPossible values:

created_atstring · date-timeOptional

updated_atstring · date-time · nullableOptional

get

/v1/brands/{siteId}/notebook

HTTPcURLJavaScriptPython

GET /v1/brands/{siteId}/notebook HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

List of notebook entries

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "content": "text",
    "meeting_date": "2026-04-02",
    "source": "text",
    "processing_status": "pending",
    "created_at": "2026-04-02T00:48:31.101Z",
    "updated_at": "2026-04-02T00:48:31.101Z"
  }
]

Create a notebook entry

post

Add a new client note or meeting transcript. Content is automatically indexed for RAG.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

siteIdstring · uuidRequired

Site ID

Body

application/json

titlestring · max: 500Required

contentstring · max: 100000Required

meeting_datestring · date · nullableOptional

Responses

201

Entry created

application/json

post

/v1/brands/{siteId}/notebook

HTTPcURLJavaScriptPython

POST /v1/brands/{siteId}/notebook HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "title": "text",
  "content": "text",
  "meeting_date": "2026-04-02"
}

201

Entry created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "content": "text",
  "meeting_date": "2026-04-02",
  "source": "text",
  "processing_status": "pending",
  "created_at": "2026-04-02T00:48:31.101Z",
  "updated_at": "2026-04-02T00:48:31.101Z"
}

Get a notebook entry

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

siteIdstring · uuidRequired

entryIdstring · uuidRequired

Responses

200

Notebook entry detail

application/json

idstring · uuidOptional

titlestringOptional

contentstringOptional

meeting_datestring · date · nullableOptional

sourcestringOptional

processing_statusstring · enumOptionalPossible values:

created_atstring · date-timeOptional

updated_atstring · date-time · nullableOptional

get

/v1/brands/{siteId}/notebook/{entryId}

HTTPcURLJavaScriptPython

GET /v1/brands/{siteId}/notebook/{entryId} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Notebook entry detail

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "content": "text",
  "meeting_date": "2026-04-02",
  "source": "text",
  "processing_status": "pending",
  "created_at": "2026-04-02T00:48:31.101Z",
  "updated_at": "2026-04-02T00:48:31.101Z"
}

Update a notebook entry

put

Update an existing notebook entry. If content changes, it is re-indexed.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

siteIdstring · uuidRequired

entryIdstring · uuidRequired

Body

application/json

titlestring · max: 500Optional

contentstring · max: 100000Optional

meeting_datestring · date · nullableOptional

Responses

200

Entry updated

application/json

idstring · uuidOptional

titlestringOptional

contentstringOptional

meeting_datestring · date · nullableOptional

sourcestringOptional

processing_statusstring · enumOptionalPossible values:

created_atstring · date-timeOptional

updated_atstring · date-time · nullableOptional

put

/v1/brands/{siteId}/notebook/{entryId}

HTTPcURLJavaScriptPython

PUT /v1/brands/{siteId}/notebook/{entryId} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "title": "text",
  "content": "text",
  "meeting_date": "2026-04-02"
}

200

Entry updated

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "content": "text",
  "meeting_date": "2026-04-02",
  "source": "text",
  "processing_status": "pending",
  "created_at": "2026-04-02T00:48:31.101Z",
  "updated_at": "2026-04-02T00:48:31.101Z"
}

Delete a notebook entry

delete

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

siteIdstring · uuidRequired

entryIdstring · uuidRequired

Responses

204

Entry deleted

delete

/v1/brands/{siteId}/notebook/{entryId}

HTTPcURLJavaScriptPython

DELETE /v1/brands/{siteId}/notebook/{entryId} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

204

Entry deleted

No content