stepsFeedback

Modify Feedback For Step

Modify feedback for a given step.

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Path parameters

step_idstringRequiredformat: "^step-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"=41 characters

The ID of the step in the format ‘step-<uuid4>’

Request

This endpoint expects an object.
feedbackenum or nullOptional
Whether this feedback is positive or negative
Allowed values:
tagslist of strings or nullOptional
Feedback tags to add to the step

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
run_idstring or null
The unique identifier of the run 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.
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:
messageslist of objects or nullDeprecated

The messages generated during this step. Deprecated: use GET /v1/steps/{step_id}/messages endpoint instead

Errors