API by router
Conversations
Fleet Conversations
List conversations across all consented instances (or one specific instance).
Only returns conversations from instances where consent_debug_access=True.
AuthorizationBearer <token>
In: header
Query Parameters
instance_id?Instance Id
limit?Limit
Default
20Range
1 <= value <= 100Response Body
curl -X GET "https://loading/v1/conversations?instance_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&limit=20"{
"conversations": [
{
"conversation_id": "string",
"hostname": "string",
"instance_id": "string",
"last_message_at": "string",
"message_count": 0,
"participant": "string",
"started_at": "string",
"summary": "string"
}
],
"instance_id": "string",
"total": 0
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Fleet Inbox Overview
Fleet-wide inbox overview — shows all instances and their consent status.
Instances with consent get a conversation count from the agent runtime. Instances without consent show as locked (count=None).
AuthorizationBearer <token>
In: header
Response Body
curl -X GET "https://loading/v1/conversations/overview"{
"consented_instances": 0,
"instances": [
{
"consent_debug_access": true,
"conversation_count": 0,
"error": "string",
"hostname": "string",
"instance_id": "string",
"latest_conversation_ts": "string",
"status": "string"
}
],
"total_conversations": 0,
"total_instances": 0
}Fleet Conversation Detail
Get full conversation detail from a specific instance.
Proxies directly to the agent runtime. Requires consent_debug_access.
AuthorizationBearer <token>
In: header
Path Parameters
instance_idInstance Id
Format
uuidconversation_idConversation Id
Match
^[A-Za-z0-9:_-]{1,128}$Length
length <= 128Response Body
curl -X GET "https://loading/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/string"null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}