Read a conversation's decision trace
import requests
url = "https://platform.ankra.app/api/v1/chat/conversations/{conversation_id}/trace"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/chat/conversations/{conversation_id}/trace', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://platform.ankra.app/api/v1/chat/conversations/{conversation_id}/trace \
--header 'Authorization: Bearer <token>'{
"conversation_id": "<string>",
"organisation_id": "<string>",
"event_count": 123,
"turns": [
{
"turn_id": "<string>",
"lane": "<string>",
"session_id": "<string>",
"started_at": "<string>",
"ended_at": "<string>",
"model": "<string>",
"ending_kind": "<string>",
"events": [
{
"id": 123,
"kind": "<string>",
"at": "<string>",
"lane": "<string>",
"payload": {}
}
]
}
]
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Chat
Read a conversation's decision trace
Returns the team-readable decision trace of a chat conversation, grouped by turn: the model routing decision with its reason, the tool families offered and lazily loaded, every refused tool call with its error code, every post-hoc rewrite of the reply, every budget or loop-guard intervention, how each turn ended, and every pending-action status transition with who decided it. Organisation admins only; a conversation outside the organisation answers 404.
GET
/
api
/
v1
/
chat
/
conversations
/
{conversation_id}
/
trace
Read a conversation's decision trace
import requests
url = "https://platform.ankra.app/api/v1/chat/conversations/{conversation_id}/trace"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.ankra.app/api/v1/chat/conversations/{conversation_id}/trace', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://platform.ankra.app/api/v1/chat/conversations/{conversation_id}/trace \
--header 'Authorization: Bearer <token>'{
"conversation_id": "<string>",
"organisation_id": "<string>",
"event_count": 123,
"turns": [
{
"turn_id": "<string>",
"lane": "<string>",
"session_id": "<string>",
"started_at": "<string>",
"ended_at": "<string>",
"model": "<string>",
"ending_kind": "<string>",
"events": [
{
"id": 123,
"kind": "<string>",
"at": "<string>",
"lane": "<string>",
"payload": {}
}
]
}
]
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": "Cluster not found"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.