Skip to content
API Reference
Beta
Threads

Retrieve thread

Deprecated
beta.threads.retrieve(thread_id) -> Thread { id, created_at, metadata, 2 more }
GET/threads/{thread_id}

Retrieves a thread.

ParametersExpand Collapse
thread_id: String
ReturnsExpand Collapse
class Thread { id, created_at, metadata, 2 more }

Represents a thread that contains messages.

id: String

The identifier, which can be referenced in API endpoints.

created_at: Integer

The Unix timestamp (in seconds) for when the thread was created.

metadata: Metadata

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, and querying for objects via API or the dashboard.

Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.

object: :thread

The object type, which is always thread.

tool_resources: { code_interpreter, file_search}

A set of resources that are made available to the assistant's tools in this thread. The resources are specific to the type of tool. For example, the code_interpreter tool requires a list of file IDs, while the file_search tool requires a list of vector store IDs.

code_interpreter: { file_ids}
file_ids: Array[String]

A list of file IDs made available to the code_interpreter tool. There can be a maximum of 20 files associated with the tool.

Retrieve thread

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

thread = openai.beta.threads.retrieve("thread_id")

puts(thread)
{
  "id": "id",
  "created_at": 0,
  "metadata": {
    "foo": "string"
  },
  "object": "thread",
  "tool_resources": {
    "code_interpreter": {
      "file_ids": [
        "string"
      ]
    },
    "file_search": {
      "vector_store_ids": [
        "string"
      ]
    }
  }
}
Returns Examples
{
  "id": "id",
  "created_at": 0,
  "metadata": {
    "foo": "string"
  },
  "object": "thread",
  "tool_resources": {
    "code_interpreter": {
      "file_ids": [
        "string"
      ]
    },
    "file_search": {
      "vector_store_ids": [
        "string"
      ]
    }
  }
}