curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.example.com/api/admin/live-chat/{id}/notes' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"notes": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"text": "Two-person tent, green — replacement for damaged pole set.",
"authorName": "string",
"timestamp": "2026-08-31T14:22:05Z"
}
]
}
Read private operator notes
Private notes are available to operators in the owning organization, separately from customer transcripts…
GET
/
api
/
admin
/
live-chat
/
{id}
/
notes
curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.example.com/api/admin/live-chat/{id}/notes' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"notes": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"text": "Two-person tent, green — replacement for damaged pole set.",
"authorName": "string",
"timestamp": "2026-08-31T14:22:05Z"
}
]
}
Private notes are available to operators in the owning organization, separately from customer transcripts. Requires WIDGET_LIVE_CHAT_ENABLED=true, an admin bearer key and verified thread ownership. Responses use Cache-Control: no-store. Mutations share the customer/AI thread execution lease. Limited to 120 requests/minute per credential (shared with Redis when configured).
Path parameters
Response
object
Status codes
| Code | Meaning |
|---|---|
200 | Persisted result |
401 | Missing or invalid admin key |
404 | Thread not found in the authenticated organization |
409 | Claim, content-ID, note-limit or thread lease conflict |
429 | Rate limit exceeded |
503 | Live chat disabled or persistence unavailable |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.example.com/api/admin/live-chat/{id}/notes' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"notes": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"text": "Two-person tent, green — replacement for damaged pole set.",
"authorName": "string",
"timestamp": "2026-08-31T14:22:05Z"
}
]
}
Last modified on November 13, 2026