CEcekura
Runs

Poll a submitted API-chat turn

Changed on

Poll for the simulated user's reply to a turn submitted via POST /runs/{run_id}/chat/. status is generating until the reply is ready, then ready (with message and ended). dropped means the turn was superseded by a newer submission — its message is kept and the newer turn's reply answers both; error means generation failed. Turn 0 is the run's opening: message is the evaluator's first message, or null when your agent speaks first. Any turn stays pollable until the run's turn history expires, so the last reply is still retrievable after the run finishes.

get/test_framework/v1/runs/{id}/chat/{turn_id}/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/test_framework/v1/runs/{id}/chat/{turn_id}/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer
    • or API key in header X-VOCERA-SHAREABLE-LINK-TOKEN
    • or HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this run.

turn_idstring required

Response

run_idinteger required
result_idinteger required
turn_idinteger required
statusstring required

'generating' until ready, then 'ready' (or 'error').

messagestring nullable required

The simulated user's reply; null until status is 'ready'.

endedboolean required

True when the conversation has ended.

ended_reasonstring nullable required

Changes