v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01352368.2 KB
refine

Get Refine Status

get/refine/{session_id}/status

Path parameters

session_idstring required

Response

Refine status

session_idstring required
statusstring required

pending, running, completed, failed, cancelled, cancelling

iterationinteger

Current or final iteration number

max_iterationsinteger

Configured iteration cap

n_trialsinteger

Trials completed in current iteration

max_trialsinteger

Configured trial budget per iteration

best_scorenumber nullable

Best score observed in current/final iteration

best_paramsobject nullable

Best parameter set observed in current/final iteration

judge_scorenumber nullable

Latest judge score, when available

termination_reasonstring nullable

approved, max_iterations, cancelled, error, or null while running

elapsed_secondsinteger required

Total elapsed time in seconds

can_cancelboolean required

Whether refine can be cancelled

error_messagestring nullable

Failure reason for terminal failed refine sessions.

created_atstring required
updated_atstring required