Conversations
Send conversation feedback
Record thumbs-up or thumbs-down feedback on an event and recalculate the conversation’s resolution state.
POST
Records feedback on an event as thumbs up, thumbs down, or unrated. After saving the feedback, Fini recalculates the conversation’s
resolved value from its negatively rated Fini responses.
The request field still uses
approved for API compatibility. Treat approved as the event feedback value: true means thumbs up, false means thumbs down, and null clears the 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.
boolean | null
Feedback value. Send
true for thumbs up, false for thumbs down, or null to clear the feedback. Include this field when changing the feedback.Request example
Response
boolean
true after the event feedback and conversation state have been updated.Resolution recalculation
After the feedback is saved, Fini examines all Fini-authored events withapproved=false:
- no negatively rated Fini events sets the conversation’s
resolvedvalue tonull - all negatively rated Fini events resolved sets it to
true - any unresolved negatively rated Fini event sets it to
false
Errors
400 Bad Request
400 Bad Request
The body fails validation.
eventId must be a non-empty string, and approved, when provided, must be true, false, or null.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.

