Caller: "Can you check if my order has shipped?"
Agent: "Let me look that up for you. I'll put you on a brief hold."
-> Agent calls put_caller_on_hold
-> Hold message plays: "Please hold while I check your order status."
-> Agent queries the order system
-> Agent calls resume_from_hold
-> Resume message plays: "Thanks for holding!"
Agent: "Great news - your order shipped yesterday and is arriving tomorrow."

{
  "holdEnabled": true,
  "holdMessage": "Please hold while I look into that for you.",
  "holdResumeMessage": "Thank you for holding. I have your information now.",
  "holdMusicUrl": ""
}

Parameters:
  reason: string (why the caller is being placed on hold)

Returns: "Caller is now on hold. Reason: {reason}. Call resume_from_hold when ready."

Parameters: none

Returns: "Call resumed. Continue helping the caller."

curl -X POST https://api.thinnest.ai/v1/agents \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order Lookup Agent",
    "model": "gpt-4o-mini",
    "instructions": "You help customers check order status. When you need to look up information, put the caller on hold first. Always explain why. Resume as soon as you have the answer.",
    "voiceEnabled": true,
    "transcriber": { "provider": "deepgram", "model": "nova-2-conversationalai" },
    "voice": { "provider": "deepgram", "voiceId": "aura-2-thalia-en" },
    "holdEnabled": true,
    "holdMessage": "Please hold while I check your order status.",
    "holdResumeMessage": "Thank you for holding. I have your information now."
  }'