Class Runs

constructor

• new Runs(client): OpenAIClient.Beta.Threads.Runs

• Parameters

  • client: OpenAIClient

  Returns OpenAIClient.Beta.Threads.Runs

steps

cancel

• cancel(runID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

• Cancels a run that is in_progress.

  Parameters

  • runID: string
  • params: OpenAIClient.Beta.Threads.RunCancelParams
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

  Deprecated

  The Assistants API is deprecated in favor of the Responses API

create

• create(threadID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

• Create a run.

  Parameters

  • threadID: string
  • params: OpenAIClient.Beta.Threads.Runs.RunCreateParamsNonStreaming
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

  Deprecated

  The Assistants API is deprecated in favor of the Responses API

• create(threadID, params, options?): APIPromise<Stream<AssistantStreamEvent>>

• Parameters

  • threadID: string
  • params: OpenAIClient.Beta.Threads.Runs.RunCreateParamsStreaming
  • Optionaloptions: RequestOptions

  Returns APIPromise<Stream<AssistantStreamEvent>>

• create(threadID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run | Stream<AssistantStreamEvent>>

• Parameters

  • threadID: string
  • params: RunCreateParamsBase
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run | Stream<AssistantStreamEvent>>

createAndPoll

• createAndPoll(threadId, body, options?): Promise<OpenAIClient.Beta.Threads.Runs.Run>

• A helper to create a run an poll for a terminal state. More information on Run lifecycles can be found here: https://platform.openai.com/docs/assistants/how-it-works/runs-and-run-steps

  Parameters

  • threadId: string
  • body: OpenAIClient.Beta.Threads.Runs.RunCreateParamsNonStreaming
  • Optionaloptions: RequestOptions & {
        pollIntervalMs?: number;
    }

  Returns Promise<OpenAIClient.Beta.Threads.Runs.Run>

createAndStream

• createAndStream(threadId, body, options?): AssistantStream

• Create a Run stream

  Parameters

  • threadId: string
  • body: RunCreateParamsBaseStream
  • Optionaloptions: RequestOptions

  Returns AssistantStream

  Deprecated

  use stream instead

list

• list(threadID, query?, options?): PagePromise<RunsPage, OpenAIClient.Beta.Threads.Runs.Run>

• Returns a list of runs belonging to a thread.

  Parameters

  • threadID: string
  • Optionalquery: null | OpenAIClient.Beta.Threads.Runs.RunListParams
  • Optionaloptions: RequestOptions

  Returns PagePromise<RunsPage, OpenAIClient.Beta.Threads.Runs.Run>

  Deprecated

  The Assistants API is deprecated in favor of the Responses API

poll

• poll(runId, params, options?): Promise<OpenAIClient.Beta.Threads.Runs.Run>

• A helper to poll a run status until it reaches a terminal state. More information on Run lifecycles can be found here: https://platform.openai.com/docs/assistants/how-it-works/runs-and-run-steps

  Parameters

  • runId: string
  • params: OpenAIClient.Beta.Threads.Runs.RunRetrieveParams
  • Optionaloptions: RequestOptions & {
        pollIntervalMs?: number;
    }

  Returns Promise<OpenAIClient.Beta.Threads.Runs.Run>

retrieve

• retrieve(runID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

• Retrieves a run.

  Parameters

  • runID: string
  • params: OpenAIClient.Beta.Threads.Runs.RunRetrieveParams
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

  Deprecated

  The Assistants API is deprecated in favor of the Responses API

stream

• stream(threadId, body, options?): AssistantStream

• Create a Run stream

  Parameters

  • threadId: string
  • body: RunCreateParamsBaseStream
  • Optionaloptions: RequestOptions

  Returns AssistantStream

submitToolOutputs

• submitToolOutputs(runID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

• When a run has the status: "requires_action" and required_action.type is submit_tool_outputs, this endpoint can be used to submit the outputs from the tool calls once they're all completed. All outputs must be submitted in a single request.

  Parameters

  • runID: string
  • params: OpenAIClient.Beta.Threads.Runs.RunSubmitToolOutputsParamsNonStreaming
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

  Deprecated

  The Assistants API is deprecated in favor of the Responses API

• submitToolOutputs(runID, params, options?): APIPromise<Stream<AssistantStreamEvent>>

• Parameters

  • runID: string
  • params: OpenAIClient.Beta.Threads.Runs.RunSubmitToolOutputsParamsStreaming
  • Optionaloptions: RequestOptions

  Returns APIPromise<Stream<AssistantStreamEvent>>

• submitToolOutputs(runID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run | Stream<AssistantStreamEvent>>

• Parameters

  • runID: string
  • params: RunSubmitToolOutputsParamsBase
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run | Stream<AssistantStreamEvent>>

submitToolOutputsAndPoll

• submitToolOutputsAndPoll(runId, params, options?): Promise<OpenAIClient.Beta.Threads.Runs.Run>

• A helper to submit a tool output to a run and poll for a terminal run state. More information on Run lifecycles can be found here: https://platform.openai.com/docs/assistants/how-it-works/runs-and-run-steps

  Parameters

  • runId: string
  • params: OpenAIClient.Beta.Threads.Runs.RunSubmitToolOutputsParamsNonStreaming
  • Optionaloptions: RequestOptions & {
        pollIntervalMs?: number;
    }

  Returns Promise<OpenAIClient.Beta.Threads.Runs.Run>

submitToolOutputsStream

• submitToolOutputsStream(runId, params, options?): AssistantStream

• Submit the tool outputs from a previous run and stream the run to a terminal state. More information on Run lifecycles can be found here: https://platform.openai.com/docs/assistants/how-it-works/runs-and-run-steps

  Parameters

  • runId: string
  • params: RunSubmitToolOutputsParamsStream
  • Optionaloptions: RequestOptions

  Returns AssistantStream

update

• update(runID, params, options?): APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

• Modifies a run.

  Parameters

  • runID: string
  • params: RunUpdateParams
  • Optionaloptions: RequestOptions

  Returns APIPromise<OpenAIClient.Beta.Threads.Runs.Run>

  Deprecated

  The Assistants API is deprecated in favor of the Responses API