API by router
Conversations
GET
HTTPBearerheader
AuthorizationBearer <token>instance_id?|nulllimit?LimitRange
1 <= value <= 100Default
20Successful Response
application/json- response
Paginated fleet-level conversation list.
conversations*array<>instance_id?string|nulltotal*Totalcurl -X GET 'https://example.com/v1/conversations'Example Response
{ "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}GET
HTTPBearerheader
AuthorizationBearer <token>Successful Response
application/json- response
Fleet-wide conversation inbox overview.
consented_instances*Consented Instancesinstances*array<>total_conversations*Total Conversationstotal_instances*Total Instancescurl -X GET 'https://example.com/v1/conversations/overview'Example Response200
{ "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}GET
HTTPBearerheader
AuthorizationBearer <token>instance_id*Instance IdFormat
uuidconversation_id*Conversation IdMatch
^[A-Za-z0-9:_-]{1,128}$Length
length <= 128Successful Response
response?unknownapplication/jsoncurl -X GET 'https://example.com/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/string'Example Response
null