Struct Threads 

pub struct Threads<'c, C: Config> { /* private fields */ }

👎Deprecated: Assistants API is deprecated and will be removed in August 2026. Use the Responses API.

Available on crate feature assistant only.

Create threads that assistants can interact with.

Related guide: Assistants

Implementations

impl<'c, C: Config> Threads<'c, C>

pub fn new(client: &'c Client<C>) -> Self

pub fn messages(&self, thread_id: &str) -> Messages<'_, C>

Call Messages group API to manage message in thread_id thread.

pub fn runs(&self, thread_id: &str) -> Runs<'_, C>

Call Runs group API to manage runs in thread_id thread.

pub async fn create_and_run( &self, request: CreateThreadAndRunRequest, ) -> Result<RunObject, OpenAIError>

Create a thread and run it in one request.

pub async fn create_and_run_byot<T0: Serialize, R: DeserializeOwned>( &self, request: T0, ) -> Result<R, OpenAIError>

Create a thread and run it in one request.

pub async fn create_and_run_stream( &self, request: CreateThreadAndRunRequest, ) -> Result<AssistantEventStream, OpenAIError>

Create a thread and run it in one request (streaming).

byot: You must ensure “stream: true” in serialized request

pub async fn create_and_run_stream_byot<T0: Serialize, R>( &self, request: T0, ) -> Result<Pin<Box<dyn Stream<Item = Result<R, OpenAIError>> + Send>>, OpenAIError>

where R: Send + 'static + TryFrom<Event, Error = OpenAIError> + DeserializeOwned,

Create a thread and run it in one request (streaming).

byot: You must ensure “stream: true” in serialized request

pub async fn create( &self, request: CreateThreadRequest, ) -> Result<ThreadObject, OpenAIError>

Create a thread.

pub async fn create_byot<T0: Serialize, R: DeserializeOwned>( &self, request: T0, ) -> Result<R, OpenAIError>

Create a thread.

pub async fn retrieve( &self, thread_id: &str, ) -> Result<ThreadObject, OpenAIError>

Retrieves a thread.

pub async fn retrieve_byot<T0: Display, R: DeserializeOwned>( &self, thread_id: T0, ) -> Result<R, OpenAIError>

Retrieves a thread.

pub async fn update( &self, thread_id: &str, request: ModifyThreadRequest, ) -> Result<ThreadObject, OpenAIError>

Modifies a thread.

pub async fn update_byot<T0: Display, T1: Serialize, R: DeserializeOwned>( &self, thread_id: T0, request: T1, ) -> Result<R, OpenAIError>

Modifies a thread.

pub async fn delete( &self, thread_id: &str, ) -> Result<DeleteThreadResponse, OpenAIError>

Delete a thread.

pub async fn delete_byot<T0: Display, R: DeserializeOwned>( &self, thread_id: T0, ) -> Result<R, OpenAIError>

Delete a thread.

Trait Implementations

impl<'c, C: Config> RequestOptionsBuilder for Threads<'c, C>

Available on crate feature _api only.

fn options_mut(&mut self) -> &mut RequestOptions

Get mutable reference to RequestOptions (for building)

fn options(&self) -> &RequestOptions

Get reference to RequestOptions

fn headers(self, headers: HeaderMap) -> Self

Add headers to RequestOptions

fn header<K, V>(self, key: K, value: V) -> Result<Self, OpenAIError>

where K: IntoHeaderName, V: TryInto<HeaderValue>, V::Error: Into<InvalidHeaderValue>,

Add a single header to RequestOptions

fn query<Q: Serialize + ?Sized>(self, query: &Q) -> Result<Self, OpenAIError>

Add query parameters to RequestOptions

fn path<P: Into<String>>(self, path: P) -> Result<Self, OpenAIError>

Add a path to RequestOptions