curl --request PATCH \
--url https://{projectID}.texterchat.com/server/api/v2/chats/{chatId}/chat-notes/{noteId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"text": "Refund approved, order 1234"
}
'{
"_id": "6731f0c2a1b2c3d4e5f60718",
"chatId": "67a87067aeed4dee1271cb4d",
"text": "Refund approved, order 1234",
"messageId": "6731efa0a1b2c3d4e5f60701",
"author": {
"actor": {
"type": "jwt",
"issuer": "https://texterchat.com/demo",
"kid": "a1b2c3"
},
"customName": "Refunds system"
},
"createdAt": 1762851000000,
"updatedAt": 1762851300000,
"lastEditor": {
"actor": {
"type": "jwt",
"issuer": "https://texterchat.com/demo",
"kid": "a1b2c3"
}
}
}Chat Notes
Update Chat Note
Replace the text of a chat note. Any note of the chat can be edited, including notes written by agents.
PATCH
https://{projectID}.texterchat.com/server/api/v2
/
chats
/
{chatId}
/
chat-notes
/
{noteId}
curl --request PATCH \
--url https://{projectID}.texterchat.com/server/api/v2/chats/{chatId}/chat-notes/{noteId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"text": "Refund approved, order 1234"
}
'{
"_id": "6731f0c2a1b2c3d4e5f60718",
"chatId": "67a87067aeed4dee1271cb4d",
"text": "Refund approved, order 1234",
"messageId": "6731efa0a1b2c3d4e5f60701",
"author": {
"actor": {
"type": "jwt",
"issuer": "https://texterchat.com/demo",
"kid": "a1b2c3"
},
"customName": "Refunds system"
},
"createdAt": 1762851000000,
"updatedAt": 1762851300000,
"lastEditor": {
"actor": {
"type": "jwt",
"issuer": "https://texterchat.com/demo",
"kid": "a1b2c3"
}
}
}Required token scopes:
Edit and delete notes of all chats
The original author stays as it is. Your API token becomes the note’s lastEditor, with customName when you send one.
Sending the same text as the saved text changes nothing and returns the note as it is. The editor name can change only together with the text: the same text with a different customName returns 400.Authorizations
API token generated in Texter: gear icon → Developers → API Tokens. When creating a token, assign it the scopes required by the endpoints you plan to call - each endpoint lists its required scopes.
Path Parameters
The unique identifier of the chat. You can obtain this value by using the Search Chats endpoint with the contact's phone number
The unique identifier of the note (_id). You can obtain it from List Chat Notes or from the response of Create Chat Note
Body
application/json
The new note text, up to 4096 characters
Maximum string length:
4096Editor name shown in the inbox instead of the default. Up to 50 characters, must contain a visible character
Maximum string length:
50Response
The updated note
An internal note on a chat
Unique note ID
Example:
"6731f0c2a1b2c3d4e5f60718"
ID of the chat the note belongs to
Example:
"67a87067aeed4dee1271cb4d"
The note text
Who wrote the note. Kept as it is on every edit
Show child attributes
Show child attributes
Creation time, Unix milliseconds
Example:
1762851000000
Last change time, Unix milliseconds
Example:
1762851000000
ID of the chat message the note is attached to. Missing when the chat had no messages
Who made the last text edit. Missing on notes that were never edited
Show child attributes
Show child attributes