Skip to main content
GET
/
v1
/
v2
/
conversations
/
{conversation_id}
/
engineering
/
turns
/
{turn_id}
Get the reconstructed engineering waterfall for a single v2 turn
curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/v2/conversations/{conversation_id}/engineering/turns/{turn_id} \
  --header 'x-api-key: <api-key>'
{
  "turn_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "trace": {}
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
conversation_id
string<uuid>
required
​
turn_id
string<uuid>
required

Response

Successful Response

Full per-turn engineering waterfall, reconstructed from Langfuse (ENG-689 T3).

trace is the TurnState.to_telemetry_dict() artifact the rich waterfall UI already renders (the live playground SSE stream emits the same shape). It is metadata-only at the production tier and carries the debug-tier fields when debug capture was on for the turn, mirroring the old self-hosted debug_log.

​
turn_id
string<uuid>
required
​
conversation_id
string<uuid>
required
​
trace
Trace · object
required