Skip to content

InteractionProcessContextToolResult

The result of a tool call. The result itself is usually kept apart from the run: read it with the run’s tool-results call, by this item’s sequence.

Kind: an object, used in responses.

Every field is present in a response; empty ones are null.

FieldTypeDescription
toolCallIdstringThe toolCallId of the call this is the result of.
resultstring | nullThe tool’s result, when it is kept on the run. Null when it is kept apart (toolResultId is then set): read it by this item’s sequence from the run’s tool-results call.
isErrorbooleanTrue when the result is an error: the call failed, or a person rejected it.
toolResultIduuid | nullThe id of the result kept apart from the run. Null when result holds it.
resultSizeinteger | nullThe size of the tool’s whole result in bytes (UTF-8), before any shortening, so you can tell how large it is without reading it. May be null when result holds it.
rejectionReasonstring | nullThe reason a person gave when they rejected this call (the result is then an error telling the agent not to try again). Null for an ordinary result. Show this rather than parsing the result text.
sequenceintegerThe item’s position in the run’s conversation. Sort every item in context by it to read the conversation in order.
authorInteractionProcessContextAuthorWho wrote the item.
datedatetimeWhen the item was written (UTC).
threadIdstring | nullThe conversation thread the item is on. Null is the main thread, the conversation the participants share. Every other thread belongs to one participant: private:<participant> (a managed agent’s private conversation with its manager), dispatch:<participant>:<id> (one dispatch’s working) and question:<participant>:<id> (how a participant reached its answer to a direct question).
{
"toolCallId": "...",
"result": "...",
"isError": false,
"toolResultId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"resultSize": 0,
"rejectionReason": "...",
"sequence": 0,
"author": {
"id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"name": "...",
"type": "Human"
},
"date": "2026-10-26T12:00:00.0000000Z",
"threadId": "..."
}