Conversations
Add feedback note
Save or clear a teammate feedback note on a conversation event.
POST
Saves free-text feedback on one event, then updates the parent conversation’s
hasFeedback flag. Use this endpoint for qualitative notes that explain why a response was marked wrong or what should change.
To record the thumbs-up or thumbs-down value itself, use Send conversation feedback.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs write scope.string
required
Send
application/json.Path parameters
string
required
Conversation ID containing the event.
Body parameters
string
required
ID of the event to update. The event must belong to the conversation and workspace.
string
Feedback note to store on the event. Send an empty string to clear the note.
Response
boolean
true after the event feedback note and conversation feedback flag have been updated.Feedback flag
Whenfeedback is non-empty, Fini sets the conversation’s hasFeedback flag to true. When feedback is empty, Fini clears this event’s note and leaves hasFeedback true only if another event in the same conversation still has feedback.
Errors
400 Bad Request
400 Bad Request
The body fails validation.
eventId must be a non-empty string, and feedback, when provided, must be a string.403 Forbidden
403 Forbidden
The API key does not include the
write scope required for this route.406 Not Acceptable
406 Not Acceptable
The conversation or event is inaccessible, the conversation has no events, or the supplied event does not exist in the conversation.
500 Internal Server Error
500 Internal Server Error
Fini could not load or update the requested conversation event.

