HTTP API
ToolInvocationRecord
The summary of a single completed tool call.
Shape: object
| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
id |
yes | string (uuid) |
The record identifier. A time-ordered UUID (v7). | — |
runId |
yes | string (uuid) |
The run that made the call. | — |
toolName |
yes | string |
The name of the tool called. | — |
toolCallId |
no | string |
The call identifier generated by the model. Distinguishes multiple calls of the same kind. | — |
source |
no | string |
The tool’s source. null for tools defined in code; the server name for MCP tools. |
— |
arguments |
no | string |
The call arguments. Raw text; may not be valid JSON. | — |
result |
no | string |
The call result. Raw text; may not be valid JSON. | — |
duration |
no | string |
The call’s duration. null if the event pair did not match. |
pattern ^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$ |
error |
no | string |
The error message. Populated only if the call errored. | — |
createdAt |
yes | string (date-time) |
The moment the call settled (UTC). | — |
usage |
no | null oneOf ToolCallUsage |
— | — |
authorizationDenied |
no | boolean |
Whether IToolAuthorizationHandler denied this call before it ran. | — |
timedOut |
no | boolean |
Whether the call ended because its execution timeout elapsed (TraconToolTimeoutException). | — |
lateCompletedAt |
no | string (date-time) |
The moment a call that had already been reported as timed out actually settled (UTC). null for every call that settled within its own timeout. |
— |
succeeded |
no | boolean |
Whether the call finished successfully. | — |