Skip to main content
Refine with AI lets your backend queue an AI-assisted review for a specific Fini response, then poll the review session until Fini has generated recommendations and replayed the answer. Use these routes when you already have the conversation ID and Fini-authored event ID for the response you want to improve. Use List conversations or Get conversation to discover those IDs first.
Creating a review iteration can generate draft prompt, article, or rule recommendations. It does not publish or apply those changes automatically.

​
Endpoints

​
Review flow

1

Find the Fini response

Fetch the conversation and choose the Fini-authored event you want to review.
2

Create an iteration

Send the feedback note to the create endpoint. Fini creates or reuses the active review session for that response.
3

Poll the session

Use the returned sessionId, or the active-session route, to read progress while the iteration moves through analysis and replay.
4

Inspect the recommendation

When latestIteration.status is ready, compare the original and replayed answer snapshots, then inspect changes for the proposed draft IDs and root-cause details.

​
Shared objects

The session endpoints return a FixReviewSession shape. For the full field list, see Get active fix-review session. Key fields to handle in integrations:
  • sessionId: review session ID for the selected response.
  • latestIteration: the newest queued, running, or completed review iteration.
  • iterations: all iterations in the session, ordered newest first.
  • originalAnswerSnapshot: the response Fini originally sent.
  • latestIteration.newAnswerSnapshot: the replayed answer generated after the proposed fix.
  • latestIteration.changes: draft prompt, article, or rule recommendations created by the review.