HydraCore
API by router

Agent routing

Route To Agent

POST
/internal/v1/instances/{instance_id}/route-to-agent

Path Parameters

instance_id*Instance Id
Formatuuid

Request Body

application/json
  1. body
context?

Handoff context (caller info, request summary, etc.)

conversation_id?string|null
create_workflow_record?Create Workflow Record
Defaulttrue
customer_id*Customer Id
Formatuuid
message*Message
Lengthlength <= 8000
target_instance_id?|null
target_role?|

Agent role — must match agent_config.agent.role

Response Body

Successful Response

application/json
  1. response
response?string|null
routed_to*Routed To
target_instance_id*Target Instance Id
workflow_record_id?string|null
Example Request
curl -X POST 'https://example.com/internal/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/route-to-agent' \  -H 'Content-Type: application/json' \  -d '{  "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",  "message": "string"}'
Example Response
{  "response": "string",  "routed_to": "string",  "target_instance_id": "string",  "workflow_record_id": "string"}