HydraCore
API by router

Conversations

Fleet Conversations

GET
/v1/conversations

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Query Parameters

instance_id?|null
limit?Limit
Range1 <= value <= 100
Default20

Response Body

Successful Response

application/json
  1. response

Paginated fleet-level conversation list.

conversations*array<>
instance_id?string|null
total*Total
Example Request
curl -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}

Fleet Inbox Overview

GET
/v1/conversations/overview

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Response Body

Successful Response

application/json
  1. response

Fleet-wide conversation inbox overview.

consented_instances*Consented Instances
instances*array<>
total_conversations*Total Conversations
total_instances*Total Instances
Example Request
curl -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
/v1/conversations/{instance_id}/{conversation_id}

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

instance_id*Instance Id
Formatuuid
conversation_id*Conversation Id
Match^[A-Za-z0-9:_-]{1,128}$
Lengthlength <= 128

Response Body

Successful Response

response?unknownapplication/json
Example Request
curl -X GET 'https://example.com/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/string'
Example Response
null