Represents a streamed chunk of a tool assisted chat completion response returned by model, based on the provided input.

This API is currently in Beta. While we strive to provide a stable and reliable experience, this feature is still under active development. As a result, you may encounter unexpected behavior or limitations. We encourage you to provide feedback to help us improve the feature before its official release.

choices
object[]
created
integer

The Unix timestamp (in seconds) for when the token sampled.

event: tool_status chunk object

event: tool_status tracks the execution progress of built-in tools, such as calculator or web search functions. It provides real-time updates on their status and results.

tool_call_id
string

The ID of the tool call.

name
enum<string>

The name of the built-in tool.

Available options: math:calculator, math:statistics, math:calendar, web:search, web:url, code:python-interpreter, file:text

status
enum<string>

Indicates the current execution status of the tool.

Available options: STARTED, UPDATING, ENDED, ERRORED

parameters
object[]
result
string

The output from the tool’s execution.

files
object[]
message
string

Message generated by the tool’s execution.

error
object
timestamp
number

The Unix timestamp (in seconds) for when the event occurred.