Skip to main content
POST
Sets an event’s approval value to thumbs up, thumbs down, or unrated. After updating the event, Fini recalculates the conversation’s resolved value from its negatively rated Fini responses.

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
Approval value. Send true for thumbs up, false for thumbs down, or null to clear the rating. Include this field when changing the rating.

Request example

Response

boolean
true after the event and conversation state have been updated.

Resolution recalculation

After the rating is saved, Fini examines all Fini-authored events with approved=false:
  • no negatively rated Fini events sets the conversation’s resolved value to null
  • all negatively rated Fini events resolved sets it to true
  • any unresolved negatively rated Fini event sets it to false

Errors

The body fails validation. eventId must be a non-empty string, and approved, when provided, must be true, false, or null.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.
The conversation or event is inaccessible, the conversation has no events, or the supplied event does not exist in the conversation.
Fini could not load or update the requested conversation event.