POSThttps://app.evoriqa.com/api/v1/conversations/{conversationId}/notes

Add an internal note

Adds an internal note, authored as the workspace owner (body is trimmed before validation). `@mentions` resolve to workspace members.

Requires scope conversations:write

Access is gated — enable it before your first call

The API is off by default. A request succeeds only when all three switches are on: the platform master switch (off by default), your organisation’s API toggle, and your plan or client entitlement. Any one off returns 403 API access is not enabled for this workspace.

Parameters

Name	In	Type	Required	Default	Description
conversationId	path	string uuid	Required	—	The conversation's id.

Request body

Content type: application/json

Field	Type	Required	Description
body	string 1–4000 chars	Required	The note text.

Request

curl

curl -X POST "https://app.evoriqa.com/api/v1/conversations/{conversationId}/notes" \
  -H "x-api-key: $EVORIQA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Customer is on the enterprise trial — loop in sales." }'

Node.js

const res = await fetch("https://app.evoriqa.com/api/v1/conversations/{conversationId}/notes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EVORIQA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "body": "Customer is on the enterprise trial — loop in sales."
  }),
});

const responseBody = await res.json();

Python

import os
import requests

res = requests.post(
    "https://app.evoriqa.com/api/v1/conversations/{conversationId}/notes",
    headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
    json={
      "body": "Customer is on the enterprise trial — loop in sales."
    },
)

body = res.json()

Response

200 OK

{
  "success": true,
  "data": {
    "id": "4d3c2b1a-0f9e-4d8c-8b7a-6f5e4d3c2b1a",
    "mentions": []
  }
}