Create Run

Options

OpenAI Beta

Calls to the Assistants API require that you pass a beta HTTP header.

Thread Id

The ID of the thread to run.

Body

Request body which must comply to the following JSON Schema:

{
  "required" : [ "assistant_id", "thread_id" ],
  "type" : "object",
  "properties" : {
    "assistant_id" : {
      "type" : "string",
      "description" : "The ID of the [assistant](/docs/api-reference/assistants) to use to execute this run."
    },
    "model" : {
      "type" : "string",
      "description" : "The ID of the [Model](/docs/api-reference/models) to be used to execute this run. If a value is provided here, it will override the model associated with the assistant. If not, the model associated with the assistant will be used.",
      "nullable" : true
    },
    "instructions" : {
      "type" : "string",
      "description" : "Overrides the [instructions](/docs/api-reference/assistants/createAssistant) of the assistant. This is useful for modifying the behavior on a per-run basis.",
      "nullable" : true
    },
    "additional_instructions" : {
      "type" : "string",
      "description" : "Appends additional instructions at the end of the instructions for the run. This is useful for modifying the behavior on a per-run basis without overriding other instructions.",
      "nullable" : true
    },
    "tools" : {
      "maxItems" : 20,
      "type" : "array",
      "description" : "Override the tools the assistant can use for this run. This is useful for modifying the behavior on a per-run basis.",
      "nullable" : true,
      "items" : {
        "oneOf" : [ {
          "title" : "Code interpreter tool",
          "required" : [ "type" ],
          "type" : "object",
          "properties" : {
            "type" : {
              "type" : "string",
              "description" : "The type of tool being defined: `code_interpreter`",
              "enum" : [ "code_interpreter" ]
            }
          }
        }, {
          "title" : "Retrieval tool",
          "required" : [ "type" ],
          "type" : "object",
          "properties" : {
            "type" : {
              "type" : "string",
              "description" : "The type of tool being defined: `retrieval`",
              "enum" : [ "retrieval" ]
            }
          }
        }, {
          "title" : "Function tool",
          "required" : [ "function", "type" ],
          "type" : "object",
          "properties" : {
            "type" : {
              "type" : "string",
              "description" : "The type of tool being defined: `function`",
              "enum" : [ "function" ]
            },
            "function" : {
              "required" : [ "name" ],
              "type" : "object",
              "properties" : {
                "description" : {
                  "type" : "string",
                  "description" : "A description of what the function does, used by the model to choose when and how to call the function."
                },
                "name" : {
                  "type" : "string",
                  "description" : "The name of the function to be called. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64."
                },
                "parameters" : {
                  "type" : "object",
                  "additionalProperties" : true,
                  "description" : "The parameters the functions accepts, described as a JSON Schema object. See the [guide](/docs/guides/text-generation/function-calling) for examples, and the [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for documentation about the format. \n\nOmitting `parameters` defines a function with an empty parameter list."
                }
              }
            }
          }
        } ],
        "x-oaiExpandable" : true
      }
    },
    "metadata" : {
      "type" : "object",
      "description" : "metadata_description",
      "nullable" : true,
      "x-oaiTypeLabel" : "map"
    }
  },
  "additionalProperties" : false
}

Result Format

Specify how the response should be mapped to the table output. The following formats are available:

Raw Response: Returns the raw response in a single row with the following columns:

• body: Response body
• status: HTTP status code

Views

This node has no views

Workflows

• No workflows found

Links

• API Reference

  platform.openai.com/docs/api-reference/runs/createRun

Developers