The run step object (v1)
Legacy

Represents a step in execution of a run.source

The identifier of the run step, which can be referenced in API endpoints.source

The object type, which is always thread.run.step.source

The Unix timestamp (in seconds) for when the run step was created.source

The ID of the assistant associated with the run step.source

The ID of the thread that was run.source

The ID of the run that this run step is a part of.source

The type of run step, which can be either message_creation or tool_calls.source

The status of the run step, which can be either in_progress, cancelled, failed, completed, or expired.source

The details of the run step.source

The last error associated with this run step. Will be null if there are no errors.source

The Unix timestamp (in seconds) for when the run step expired. A step is considered expired if the parent run is expired.source

The Unix timestamp (in seconds) for when the run step was cancelled.source

The Unix timestamp (in seconds) for when the run step failed.source

The Unix timestamp (in seconds) for when the run step completed.source

Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Keys can be a maximum of 64 characters long and values can be a maxium of 512 characters long.source

OBJECT The run step object (v1)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "id": "step_abc123",
  "object": "thread.run.step",
  "created_at": 1699063291,
  "run_id": "run_abc123",
  "assistant_id": "asst_abc123",
  "thread_id": "thread_abc123",
  "type": "message_creation",
  "status": "completed",
  "cancelled_at": null,
  "completed_at": 1699063291,
  "expired_at": null,
  "failed_at": null,
  "last_error": null,
  "step_details": {
    "type": "message_creation",
    "message_creation": {
      "message_id": "msg_abc123"
    }
  },
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 456,
    "total_tokens": 579
  }
}