idstring required
The id of the step. Assigned by the database.
originstring nullable
The surface that this agent step was initiated from.
provider_idstring nullable
The unique identifier of the provider that was configured for this step
run_idstring nullable
The unique identifier of the run that this step belongs to. Only included for async calls.
agent_idstring nullable
The ID of the agent that performed the step.
provider_namestring nullable
The name of the provider used for this step.
provider_categorystring nullable
The category of the provider used for this step.
modelstring nullable
The name of the model used for this step.
model_endpointstring nullable
The model endpoint url used for this step.
context_window_limitinteger nullable
The context window limit configured for this step.
completion_tokensinteger nullable
The number of tokens generated by the agent during this step.
prompt_tokensinteger nullable
The number of tokens in the prompt during this step.
total_tokensinteger nullable
The total number of tokens processed by the agent during this step.
completion_tokens_detailsobject nullable
stop_reason'end_turn' | 'error' | 'llm_api_error' | 'invalid_llm_response' | 'invalid_tool_call' | 'max_steps' | 'no_tool_call' | 'tool_rule' | 'cancelled' | 'requires_approval'
tidstring nullable
The unique identifier of the transaction that processed this step.
trace_idstring nullable
The trace id of the agent step.
feedback'positive' | 'negative' nullable
The feedback for this step. Must be either 'positive' or 'negative'.
project_idstring nullable
The project that the agent that executed this step belongs to (cloud only).
error_typestring nullable
The type/class of the error that occurred
error_dataobject nullable
Error details including message, traceback, and additional context
status'pending' | 'success' | 'failed' | 'cancelled'
Status of a step execution