Agent Tool Execution

Events that fire when an AI agent finishes a tool call.

Events

Event	When it fires
`agent_tool_execution.completed`	An agent tool call reaches a terminal status (succeeded or failed).

Examples

Each example is the full POST body Whippy sends, including the envelope fields data, api_version, event, created_at, and request_id.

`agent_tool_execution.completed`

An agent tool call reaches a terminal status (succeeded or failed).

{
  "data": {
    "id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
    "organization_id": "4e2afdc4-1ebe-4882-b4c2-29b9f17f27e1",
    "agent_id": "ce52b7c6-dc4e-46cc-8c00-0f5d7ae657de",
    "agent_version_id": "0304743f-6cbf-49c3-823b-d1d14bf36601",
    "llm_id": "191548c3-30cc-4cf7-85de-78d7387188c0",
    "llm_version_id": null,
    "tool_id": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
    "tool_name": "get_contact",
    "tool_type": "custom",
    "call_id": "d649233e-9127-4ae3-b90e-09611ed94868",
    "message_id": "d649233e-9127-4ae3-b90e-09611ed94868",
    "conversation_id": "cd4dfb23-9a86-4c11-9240-efbfd7fec874",
    "contact_id": "630fc392-ad52-4e12-a07a-889cb5aed359",
    "channel_id": "95623f0a-4d88-45b6-8074-4a83748d2103",
    "conversation_agent_session_id": null,
    "provider": "retell",
    "provider_tool_call_id": "toolu_01example",
    "channel_type": "phone",
    "status": "succeeded",
    "status_code": 200,
    "request": {
      "contact_id": "630fc392-ad52-4e12-a07a-889cb5aed359"
    },
    "response": {
      "id": "630fc392-ad52-4e12-a07a-889cb5aed359",
      "name": "Ada Lovelace"
    },
    "error_message": null,
    "latency_ms": 142,
    "source": "live_call",
    "metadata": {},
    "started_at": "2025-08-19T06:40:50.000000Z",
    "completed_at": "2025-08-19T06:40:50.142000Z",
    "inserted_at": "2025-08-19T06:40:50.000000Z",
    "updated_at": "2025-08-19T06:40:50.142000Z",
    "knowledge_bases": []
  },
  "api_version": "v1",
  "event": "agent_tool_execution.completed",
  "created_at": "2025-08-19T06:40:57.416929Z",
  "request_id": "312b99db-f964-5397-9171-2d1d44f2d801"
}