steps

List Steps

List steps with optional pagination and date filters. Dates should be provided in ISO 8601 format (e.g. 2025-01-29T15:01:19-08:00)

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

X-Projectstring or nullOptional

Filter by project slug to associate with the group (cloud only).

Query parameters

beforestring or nullOptional
Return steps before this step ID
afterstring or nullOptional
Return steps after this step ID
limitinteger or nullOptionalDefaults to 50
Maximum number of steps to return
orderstring or nullOptionalDefaults to desc

Sort order (asc or desc)

start_datestring or nullOptional

Return steps after this ISO datetime (e.g. “2025-01-29T15:01:19-08:00”)

end_datestring or nullOptional

Return steps before this ISO datetime (e.g. “2025-01-29T15:01:19-08:00”)

modelstring or nullOptional
Filter by the name of the model used for the step
agent_idstring or nullOptional
Filter by the ID of the agent that performed the step
trace_idslist of strings or nullOptional
Filter by trace ids returned by the server
feedbackenum or nullOptional
Filter by feedback
Allowed values:
has_feedbackboolean or nullOptional

Filter by whether steps have feedback (true) or not (false)

tagslist of strings or nullOptional
Filter by tags
project_idstring or nullOptional

Filter by the project ID that is associated with the step (cloud only).

Response

Successful Response
idstring
The id of the step. Assigned by the database.
originstring or null
The surface that this agent step was initiated from.
provider_idstring or null
The unique identifier of the provider that was configured for this step
job_idstring or null
The unique identifier of the job that this step belongs to. Only included for async calls.
agent_idstring or null
The ID of the agent that performed the step.
provider_namestring or null
The name of the provider used for this step.
provider_categorystring or null
The category of the provider used for this step.
modelstring or null
The name of the model used for this step.
model_endpointstring or null
The model endpoint url used for this step.
context_window_limitinteger or null
The context window limit configured for this step.
completion_tokensinteger or null
The number of tokens generated by the agent during this step.
prompt_tokensinteger or null
The number of tokens in the prompt during this step.
total_tokensinteger or null
The total number of tokens processed by the agent during this step.
completion_tokens_detailsmap from strings to any or null
Metadata for the agent.
stop_reasonenum or null
The stop reason associated with the step.
tagslist of strings or null
Metadata tags.
tidstring or null
The unique identifier of the transaction that processed this step.
trace_idstring or null
The trace id of the agent step.
messageslist of objects or null
The messages generated during this step.
feedbackenum or null
The feedback for this step. Must be either 'positive' or 'negative'.
Allowed values:
project_idstring or null

The project that the agent that executed this step belongs to (cloud only).

error_typestring or null

The type/class of the error that occurred

error_datamap from strings to any or null
Error details including message, traceback, and additional context
statusenum or null

Step status: pending, success, or failed

Allowed values:

Errors