Add a note to an investor
/investors/{investor_id}/notesAdds a note about the investor, written by the token's user, and returns it with a Location. The first note creates the investor's note thread. An investor who is not linked to your organisation, or an unknown one, returns 404 and creates nothing. dry_run shows the result without saving it. Emits investor_note.created; no email. DELETE /investors/{investor_id}/notes/{id} undoes it.
Path parameters
The investor's id, a uuid. An unknown investor, or one outside the token's organisation and its client organisations, returns 404.
Query parameters
Validate and run the call without committing it, returning what the real call would return with
meta.dry_runset.
Headers
Makes a retry safe. Send a new UUID for each new request and reuse it only to retry that request; the first response is replayed for 24 hours.
Request body
application/json, required · InvestorNoteCreate
A short heading. Left out or null, it is stored empty.
The note text, at most 16000 characters.
{
"title": "Kickoff call",
"body": "Discussed onboarding next steps."
}Responses
{
"data": {
"id": 4210,
"title": "Kickoff call",
"body": "Discussed onboarding next steps.",
"author_id": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"created_at": "2026-06-15T10:30:00Z",
"updated_at": "2026-06-15T10:30:00Z"
}
}Authorization failed. error.code is one of org_disabled,
ip_blocked, missing_scope, scope_disabled, user_disabled.
The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per
problem, or a code documented on the operation.
Examples
curl -X POST https://your-org-domain/kong/core/api/v2/investors/{investor_id}/notes\
-H "Authorization: Bearer $HELM_API_KEY"\
-H "Content-Type: application/json"\
-d '{
"title": "Kickoff call",
"body": "Discussed onboarding next steps."
}'