Refine with AI
Get Refine with AI session
Get one Refine with AI session by ID, including all iterations and recommendations.
GET
Returns one Refine with AI session by ID. Unlike Get active Refine with AI session, this route can retrieve an
active, published, or closed session. Use it after Create Refine with AI iteration returns a sessionId, or when you need to load a known Refine with AI review session from history.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs read scope.Path parameters
string
required
Conversation ID containing the reviewed response.
string
required
ID of the reviewed Fini response.
string
required
Refine with AI session ID returned by Create Refine with AI iteration.
Request example
Response
Returns the sameFixReviewSession shape as the active-session route. The response includes originalAnswerSnapshot, latestIteration, and all iterations ordered newest first.
Use latestIteration.status to decide whether the fix review is still running or ready to inspect. When it is ready, compare latestIteration.oldAnswerSnapshot with latestIteration.newAnswerSnapshot, then inspect latestIteration.changes for generated draft IDs and rootCause details. The response shows the proposed fix and replay result; it does not publish the underlying prompt, knowledge, or rule change.
Errors
400 Bad Request
400 Bad Request
The target event is invalid for fix review, or the session does not belong to the conversation and response supplied in the path.
403 Forbidden
403 Forbidden
The API key does not include the
read scope required for this route.404 Not Found
404 Not Found
The conversation, event, or session does not exist in the workspace.
500 Internal Server Error
500 Internal Server Error
Fini could not load the session or its related records.

