One of the following:
class Function { defer_loading, description, name, 3 more }

A function defined by the application.

defer_loading: bool

Whether the function is deferred and discovered through tool search.

description: String

A description of what the function does.

minLength0
name: String

The name of the function.

minLength0
parameters: Hash[Symbol, untyped]

A JSON Schema object describing the function’s arguments.

type: :function

The type of the object. Always function.

async: bool

Whether the agent continues without waiting for the function result.

class ToolSearch { type }

Discovers deferred function tools and loads them into the model context.

type: :tool_search

The type of the object. Always tool_search.

class ProgrammaticToolCalling { enabled, type }

Enables calling tools from model-generated code.

enabled: bool

Whether tools can be called from model-generated code.

type: :programmatic_tool_calling

The type of the object. Always programmatic_tool_calling.

class Mcp { allowed_tools, connection_origin, credential_id, 5 more }

Tools provided by a remote MCP server without stored credentials.

allowed_tools: Array[String]

The MCP tools the agent may call, or null when all server tools are allowed.

minItems0
maxItems2000
connection_origin: :service | :environment

Where outbound MCP HTTP connections originate.

One of the following:
:service
:environment
credential_id: String

The vault credential selected for this MCP server, if any.

minLength0
request_metadata: Hash[Symbol, untyped]

Metadata included with requests to this MCP server.

required: bool

Whether this MCP server must initialize before the first turn.

server_label: String

A label used to identify the MCP server in tool calls.

minLength0

The credential-free transport used to connect to the MCP server.

One of the following:
class HTTP { headers, server_url, type }

Connects to an MCP server over HTTP.

headers: Hash[Symbol, String]

Non-secret HTTP headers sent to the MCP server.

server_url: String

The URL of the MCP server.

minLength0
type: :http

The type of the object. Always http.

class Stdio { args, command, cwd, 2 more }

Starts an MCP server as a local process.

args: Array[String]

Arguments passed to the MCP server command.

minItems0
maxItems2000
command: String

The command used to start the MCP server.

minLength0
cwd: String

The working directory used to start the MCP server.

minLength0
env_vars: Array[String]

Environment variable names inherited from the execution environment.

minItems0
maxItems2000
type: :stdio

The type of the object. Always stdio.

type: :mcp

The type of the object. Always mcp.

class WebSearch { allowed_domains, context_size, location, 2 more }

Web search.

allowed_domains: Array[String]

Allowed search domains, or null when the search is unrestricted.

minItems0
maxItems2000
context_size: :low | :medium | :high

The amount of search context made available to the model. Defaults to medium.

One of the following:
:low
:medium
:high
location: Location{ city, country, region, timezone}

Approximate location used to localize search results, if provided.

city: String

The city name.

minLength0
country: String

The two-letter ISO country code, such as US.

minLength0
region: String

The region or state name.

minLength0
timezone: String

The IANA timezone, such as America/Los_Angeles.

minLength0
mode: :disabled | :cached | :live

The source used for web search results.

One of the following:
:disabled
:cached
:live
type: :web_search

The type of the object. Always web_search.

class ComputerUse { include_screenshots, type }

Browser use in an OpenAI-hosted session.

include_screenshots: bool

Whether computer tool outputs include screenshots.

type: :computer_use

The type of the object. Always computer_use.

class Automations { type }

Lets the agent manage its own scheduled wakeups.

type: :automations

The type of the object. Always automations.