Route Handoff
POST /api/agents/route-handoff
Route a task handoff from one agent to another.
Facilitates smooth task transitions between agents while preserving conversation context and state.
Request Body: AgentHandoffRequest with from_agent, to_agent, and context
Returns: AgentHandoffResponse confirming handoff execution
Raises: HTTPException 503: If communication hub is not available HTTPException 404: If target agent is not available HTTPException 500: For unexpected errors
Request Body required
Section titled “Request Body required ”Agent task handoff request model.
Represents a request to hand off an ongoing task or conversation from one agent to another more suitable agent. Includes full conversation context and handoff reasoning for seamless transitions.
Fields: from_agent: Agent initiating the handoff to_agent: Agent receiving the handoff conversation_context: Full conversation history and state handoff_reason: Explanation for why handoff is occurring priority: Handoff priority level (default: “medium”) handoff_time: Timestamp when handoff was requested
Used By: - POST /api/agents/handoff endpoint - Agent handoff workflow coordination - boot coordinator orchestrator for optimal agent selection - Handoff history and analytics tracking - Multi-agent conversation management
object
Handoff timestamp
Responses
Section titled “ Responses ”Successful Response
Agent handoff execution response model.
Provides handoff status, tracking identifier, and execution results for controlled agent handoffs with context preservation.
Fields:
status: Handoff execution status (success/failed)handoff_id: Unique tracking identifier for handoffresult: Handoff execution success flagmessage: Human-readable handoff status message
Validation Error