Path parameters
-
The ID of the thread the run and run steps belong to.
-
The ID of the run the run steps belong to.
Query parameters
-
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
Default value is
20
. -
Sort order by the
created_at
timestamp of the objects.asc
for ascending order anddesc
for descending order.Values are
asc
ordesc
. Default value isdesc
. -
A cursor for use in pagination.
after
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list. -
A cursor for use in pagination.
before
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list. -
A list of additional fields to include in the response. Currently the only supported value is
step_details.tool_calls[*].file_search.results[*].content
to fetch the file search result content.See the file search tool documentation for more information.
Value is
step_details.tool_calls[*].file_search.results[*].content
.
curl \
--request GET 'https://api.openai.com/v1/threads/{thread_id}/runs/{run_id}/steps' \
--header "Authorization: Bearer $ACCESS_TOKEN"
{
"object": "list",
"data": [
{
"id": "string",
"object": "thread.run.step",
"created_at": 42,
"assistant_id": "string",
"thread_id": "string",
"run_id": "string",
"type": "message_creation",
"status": "in_progress",
"step_details": {
"type": "message_creation",
"message_creation": {
"message_id": "string"
}
},
"last_error": {
"code": "server_error",
"message": "string"
},
"expired_at": 42,
"cancelled_at": 42,
"failed_at": 42,
"completed_at": 42,
"metadata": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"usage": {
"completion_tokens": 42,
"prompt_tokens": 42,
"total_tokens": 42
}
}
],
"first_id": "step_abc123",
"last_id": "step_abc456",
"has_more": false
}