{"command":{"effect":"write","timeoutSeconds":120,"inputSchema":{"type":"object","description":"Creates a managed agent session, optionally submits initial input, and returns the session or streams its events when stream is true. See [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).","properties":{"body":{"$ref":"#/definitions/CreateAgentSessionParams"}},"required":[],"additionalProperties":false,"definitions":{"CreateAgentSessionParams":{"type":"object","properties":{"review":{"$ref":"#/definitions/SessionReviewParam"},"metadata":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":0,"maxLength":512},"propertyNames":{"type":"string","minLength":1,"maxLength":64},"minProperties":0,"maxProperties":16,"description":"Up to 16 string key-value pairs, with keys up to 64 and values up to 512 characters. Omission or null defaults to an empty map."},"agent":{"$ref":"#/definitions/SessionAgentConfigParam"},"agent_id":{"type":"string","minLength":0,"maxLength":64,"description":"The ID of a saved reusable agent. Omit `agent` to use its configuration unchanged."},"environment":{"$ref":"#/definitions/EnvironmentParam"},"vault_ids":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"The IDs of vaults made available to the session."},"input":{"anyOf":[{"$ref":"#/definitions/CreateSessionInputParam"},{"type":"null"}],"description":"Initial input to submit when the session is created. A string is shorthand for a single user message. Required when `environment.type` is `none`, or when `stream` is `true` for an environment that is not `self_hosted`; optional for self-hosted and non-streaming execution environments."},"stream":{"type":"boolean","default":false,"description":"Whether to stream session events as server-sent events. Defaults to `false`.","enum":[false,null]}},"required":["environment"],"additionalProperties":false,"description":"Parameters for creating a Managed Agents session."},"SessionReviewParam":{"type":"string","enum":["none","auto_review"],"description":"Review applied to eligible actions in a session."},"SessionAgentConfigParam":{"type":"object","properties":{"experimental":{"allOf":[{"$ref":"#/definitions/ExperimentalConfigOverridesParam"},{"default":{}}]},"model":{"type":"string","minLength":0,"maxLength":1048576,"description":"The model to use for the agent. The requested model name is preserved."},"reasoning":{"anyOf":[{"$ref":"#/definitions/ReasoningParam"},{"type":"null"}],"description":"Configuration for model reasoning. Omit to keep the current settings; pass `null` to reset to the model's default effort."},"text":{"anyOf":[{"$ref":"#/definitions/TextParam"},{"type":"null"}],"description":"Configuration for text generated by the agent."},"service_tier":{"anyOf":[{"$ref":"#/definitions/ServiceTierParam"},{"type":"null"}],"description":"The service tier used for model requests."},"instructions":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"Additional instructions appended to the agent's default base instructions. Omit to leave unchanged."},"multi_agent":{"anyOf":[{"$ref":"#/definitions/MultiAgentConfigCurrentParam"},{"type":"null"}],"description":"Configuration for creating and coordinating subagents."},"compaction":{"anyOf":[{"$ref":"#/definitions/CompactionParam"},{"type":"null"}],"description":"Context compaction settings. Omit to keep the current settings. A supplied object replaces the settings; null or an empty object enables background compaction."},"tools":{"type":["array","null"],"items":{"$ref":"#/definitions/AgentToolConfigParam"},"minItems":0,"maxItems":16384,"description":"Tools available to the agent. Omit to inherit, or pass null to clear them. The resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON."}},"additionalProperties":false,"description":"Agent configuration for a session. Omitted fields inherit from `agent_id` when supplied. Supplied objects and arrays replace the whole field, except experimental settings, which merge by key. Null resets nullable fields."},"EnvironmentParam":{"oneOf":[{"$ref":"#/definitions/EnvironmentParamNone"},{"$ref":"#/definitions/EnvironmentParamOpenaiHosted"},{"$ref":"#/definitions/EnvironmentParamSelfHosted"}],"description":"The execution environment and optional reusable template for a session."},"CreateSessionInputParam":{"oneOf":[{"type":"string","minLength":1,"maxLength":1048576},{"type":"array","items":{"$ref":"#/definitions/InputMessageParam"},"minItems":0,"maxItems":16384}],"description":"Initial input submitted when creating a session."},"ExperimentalConfigOverridesParam":{"type":"object","properties":{"time_awareness":{"type":"boolean","description":"Whether to give the model periodic current-time reminders. Omit to keep the current setting."}},"additionalProperties":false,"description":"Experimental settings to update. Omitted settings keep their current values."},"ReasoningParam":{"type":"object","properties":{"effort":{"anyOf":[{"$ref":"#/definitions/ReasoningEffortParam"},{"type":"null"}],"description":"The amount of reasoning effort the model should use. Omission lets the model select it."},"summary":{"anyOf":[{"$ref":"#/definitions/ReasoningSummaryParam"},{"type":"null"}],"description":"Controls whether the response includes a reasoning summary."}},"additionalProperties":false,"description":"Reasoning configuration for the agent."},"TextParam":{"type":"object","properties":{"format":{"anyOf":[{"$ref":"#/definitions/TextFormatParam"},{"type":"null"}],"description":"The output format. Omission uses ordinary text (`{\"type\": \"text\"}`)."},"verbosity":{"anyOf":[{"$ref":"#/definitions/VerbosityParam"},{"type":"null"}],"description":"The amount of text the model should produce. Defaults to `medium`, matching Responses."}},"additionalProperties":false,"description":"Configuration for text generated by the agent."},"ServiceTierParam":{"type":"string","enum":["auto","default","flex","priority","fast","ultrafast"],"description":"The service tier used for model requests."},"MultiAgentConfigCurrentParam":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether subagent tools are enabled."},"max_concurrent_subagents":{"type":"integer","minimum":1,"maximum":4294967295,"description":"Maximum number of subagents that may run concurrently. Defaults to 6."}},"required":["enabled"],"additionalProperties":false,"description":"Explicit configuration for creating and coordinating subagents."},"CompactionParam":{"type":"object","properties":{"async":{"type":["boolean","null"],"description":"Whether to compact context in the background. Omission or null defaults to true. Set to false to use blocking compaction. Background compaction may increase token usage."}},"additionalProperties":false,"description":"Settings for compacting the agent's context."},"AgentToolConfigParam":{"oneOf":[{"$ref":"#/definitions/AgentToolConfigParamFunction"},{"$ref":"#/definitions/AgentToolConfigParamToolSearch"},{"$ref":"#/definitions/AgentToolConfigParamProgrammaticToolCalling"},{"$ref":"#/definitions/AgentToolConfigParamMcp"},{"$ref":"#/definitions/AgentToolConfigParamWebSearch"},{"$ref":"#/definitions/AgentToolConfigParamComputerUse"},{"$ref":"#/definitions/AgentToolConfigParamAutomations"}],"description":"A tool available to the agent."},"EnvironmentParamNone":{"type":"object","properties":{"type":{"type":"string","enum":["none"],"default":"none","description":"The type of the object. Always `none`."}},"required":["type"],"additionalProperties":false,"description":"Runs the agent without an execution environment."},"EnvironmentParamOpenaiHosted":{"type":"object","properties":{"type":{"type":"string","enum":["openai_hosted"],"default":"openai_hosted","description":"The type of the object. Always `openai_hosted`."},"packages":{"anyOf":[{"$ref":"#/definitions/EnvironmentPackagesParam"},{"type":"null"}],"description":"Packages to install in the environment. Defaults to empty package lists."},"setup_commands":{"type":["array","null"],"items":{"$ref":"#/definitions/SetupCommandParam"},"minItems":0,"maxItems":16,"description":"Ordered, confidential setup commands. Command bodies are never returned."},"network":{"anyOf":[{"$ref":"#/definitions/NetworkPolicyParam"},{"type":"null"}],"description":"Network access policy for the environment. If omitted, the API version determines whether network access is enabled or disabled."},"desktop":{"anyOf":[{"$ref":"#/definitions/DesktopParam"},{"type":"null"}],"description":"Desktop provisioning. Omission or null inherits the template setting, or defaults to disabled."},"env":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":0,"maxLength":1048576},"propertyNames":{"type":"string","minLength":1,"maxLength":256},"minProperties":0,"maxProperties":1024,"description":"Environment variables made available to the agent."},"capability_directories":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Directories that contain capabilities exposed to the agent. Defaults to an empty list."},"skills":{"type":["array","null"],"items":{"$ref":"#/definitions/HostedSkillParam"},"minItems":0,"maxItems":200,"description":"Skills referenced by ID or provided as inline ZIP archives. Defaults to an empty list."},"plugins":{"type":["array","null"],"items":{"$ref":"#/definitions/HostedPluginParam"},"minItems":0,"maxItems":32,"description":"Plugins provided as inline ZIP archives. Defaults to an empty list."},"files":{"type":["array","null"],"items":{"$ref":"#/definitions/HostedEnvironmentFileParam"},"minItems":0,"maxItems":50,"description":"Files available before the agent starts. Defaults to an empty list."},"environment_id":{"type":"string","minLength":9,"maxLength":256,"description":"An existing prewarmed environment. Cannot be combined with a template or inline configuration."},"environment_template_id":{"type":"string","minLength":0,"maxLength":64,"description":"A reusable hosted template applied before inline session configuration. Omitted fields inherit the template; network overrides cannot broaden its policy."},"container_size":{"$ref":"#/definitions/ContainerSizeParam"}},"required":["type"],"additionalProperties":false,"description":"An existing OpenAI-hosted environment or new inline/template-based hosted configuration.","not":{"required":["environment_id"],"anyOf":[{"required":["packages"]},{"required":["setup_commands"]},{"required":["network"]},{"required":["desktop"]},{"required":["env"]},{"required":["capability_directories"]},{"required":["skills"]},{"required":["plugins"]},{"required":["files"]},{"required":["environment_template_id"]},{"required":["container_size"]}]}},"EnvironmentParamSelfHosted":{"type":"object","properties":{"type":{"type":"string","enum":["self_hosted"],"default":"self_hosted","description":"The type of the object. Always `self_hosted`."},"capability_directories":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Directories that contain capabilities exposed to the agent. Defaults to an empty list."},"workspace_directory":{"type":"string","minLength":0,"maxLength":1048576,"description":"Absolute project directory inside the self-hosted environment."}},"required":["type","workspace_directory"],"additionalProperties":false,"description":"An application-hosted environment configured inline."},"InputMessageParam":{"type":"object","properties":{"type":{"type":"string","enum":["message"],"default":"message","description":"The type of the input item. Always `message`."},"role":{"type":"string","enum":["user"],"default":"user","description":"The role of the message author. Always `user`."},"content":{"type":"array","items":{"$ref":"#/definitions/InputContentParam"},"minItems":0,"maxItems":16384,"description":"The content of the message."}},"required":["role","content"],"additionalProperties":false,"description":"A user message submitted to a session."},"ReasoningEffortParam":{"type":"string","enum":["none","minimal","low","medium","high","xhigh","max"],"description":"The amount of reasoning effort the model should use."},"ReasoningSummaryParam":{"type":"string","enum":["concise","detailed","auto"],"description":"The reasoning summary format requested from the model."},"TextFormatParam":{"oneOf":[{"$ref":"#/definitions/TextFormatParamText"},{"$ref":"#/definitions/TextFormatParamJsonSchema"}],"description":"The output format for generated text."},"VerbosityParam":{"type":"string","enum":["low","medium","high"],"description":"The amount of text the model should produce."},"AgentToolConfigParamFunction":{"type":"object","properties":{"type":{"type":"string","enum":["function"],"default":"function","description":"The type of the object. Always `function`."},"name":{"type":"string","minLength":0,"maxLength":1048576,"description":"The name of the function."},"description":{"type":"string","minLength":0,"maxLength":1048576,"description":"A description of what the function does."},"parameters":{"type":"object","additionalProperties":{},"propertyNames":{"type":"string","minLength":1,"maxLength":256},"minProperties":0,"maxProperties":1024,"description":"A JSON Schema object describing the function's arguments."},"defer_loading":{"type":"boolean","default":false,"description":"Whether this function is deferred and discovered through tool search. Defaults to `false`."}},"required":["type","name","description","parameters"],"additionalProperties":false,"description":"A function defined by the application."},"AgentToolConfigParamToolSearch":{"type":"object","properties":{"type":{"type":"string","enum":["tool_search"],"default":"tool_search","description":"The type of the object. Always `tool_search`."}},"required":["type"],"additionalProperties":false,"description":"Discovers deferred function tools and loads them into the model context."},"AgentToolConfigParamProgrammaticToolCalling":{"type":"object","properties":{"type":{"type":"string","enum":["programmatic_tool_calling"],"default":"programmatic_tool_calling","description":"The type of the object. Always `programmatic_tool_calling`."},"enabled":{"type":"boolean","default":true,"description":"Whether tools can be called from model-generated code. Defaults to `true`."}},"required":["type"],"additionalProperties":false,"description":"Enables calling tools from model-generated code."},"AgentToolConfigParamMcp":{"type":"object","properties":{"type":{"type":"string","enum":["mcp"],"default":"mcp","description":"The type of the object. Always `mcp`."},"server_label":{"type":"string","minLength":0,"maxLength":1048576,"description":"A label used to identify the MCP server in tool calls."},"credential_id":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The attached vault credential used to authenticate this MCP server. Optional when exactly one attached credential matches the server URL."},"transport":{"$ref":"#/definitions/McpTransportConfigParam"},"request_metadata":{"type":["object","null"],"additionalProperties":{},"propertyNames":{"type":"string","minLength":1,"maxLength":256},"minProperties":0,"maxProperties":1024,"description":"Metadata included with requests to this MCP server."},"allowed_tools":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"The MCP tools the agent may call. All server tools are allowed when omitted."},"required":{"type":"boolean","default":false,"description":"Whether this MCP server must initialize before the first turn. Defaults to `false`."},"connection_origin":{"anyOf":[{"$ref":"#/definitions/McpConnectionOriginParam"},{"type":"null"}],"description":"Selects where outbound MCP HTTP connections originate. Omitted or `service` uses the Managed Agents service network; `environment` uses the session's selected environment."}},"required":["type","server_label","transport"],"additionalProperties":false,"description":"Tools provided by a remote MCP server."},"AgentToolConfigParamWebSearch":{"type":"object","properties":{"type":{"type":"string","enum":["web_search"],"default":"web_search","description":"The type of the object. Always `web_search`."},"mode":{"anyOf":[{"$ref":"#/definitions/WebSearchModeParam"},{"type":"null"}],"description":"The source used for web search results. Defaults to `live`."},"context_size":{"anyOf":[{"$ref":"#/definitions/WebSearchContextSizeParam"},{"type":"null"}],"description":"The amount of search context made available to the model. Defaults to `medium`."},"allowed_domains":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Domains the search may include."},"location":{"anyOf":[{"$ref":"#/definitions/WebSearchLocationParam"},{"type":"null"}],"description":"Approximate location used to localize search results."}},"required":["type"],"additionalProperties":false,"description":"Web search."},"AgentToolConfigParamComputerUse":{"type":"object","properties":{"type":{"type":"string","enum":["computer_use"],"default":"computer_use","description":"The type of the object. Always `computer_use`."},"include_screenshots":{"type":"boolean","default":false,"description":"Whether computer tool outputs include screenshots. Defaults to `false`."}},"required":["type"],"additionalProperties":false,"description":"Browser use in an OpenAI-hosted session."},"AgentToolConfigParamAutomations":{"type":"object","properties":{"type":{"type":"string","enum":["automations"],"default":"automations","description":"The type of the object. Always `automations`."}},"required":["type"],"additionalProperties":false,"description":"Lets the agent manage its own scheduled wakeups."},"EnvironmentPackagesParam":{"type":"object","properties":{"python":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Python packages to install. Defaults to an empty list."},"system":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"System packages to install. Defaults to an empty list."},"npm":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"npm packages to install globally. Defaults to an empty list."}},"additionalProperties":false,"description":"Packages to install in an OpenAI-hosted environment."},"SetupCommandParam":{"type":"object","properties":{"command":{"type":"string","minLength":0,"maxLength":65536,"description":"The shell command to execute."},"cwd":{"type":["string","null"],"minLength":0,"maxLength":4096,"description":"The absolute working directory. Defaults to `/workspace`."}},"required":["command"],"additionalProperties":false,"description":"A confidential setup command executed before the hosted agent starts."},"NetworkPolicyParam":{"type":"object","properties":{"access":{"$ref":"#/definitions/NetworkAccessParam"},"allowed_domains":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Domains the environment may access when network access is restricted."},"blocked_domains":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":100,"description":"Domains blocked for both executor and browser when access is restricted. A nonempty list requires `access: restricted` and cannot be combined with nonempty `allowed_domains`. Wildcard domains are not supported."}},"required":["access"],"additionalProperties":false,"description":"Network access for an OpenAI-hosted environment."},"DesktopParam":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether to provision the desktop and its browser proxy."}},"required":["enabled"],"additionalProperties":false,"description":"Desktop configuration for an OpenAI-hosted environment."},"HostedSkillParam":{"oneOf":[{"$ref":"#/definitions/HostedSkillParamSkillReference"},{"$ref":"#/definitions/HostedSkillParamInline"}],"description":"A skill installed in an OpenAI-hosted environment."},"HostedPluginParam":{"oneOf":[{"$ref":"#/definitions/HostedPluginParamInline"}],"description":"A plugin installed in an OpenAI-hosted environment."},"HostedEnvironmentFileParam":{"oneOf":[{"$ref":"#/definitions/HostedEnvironmentFileParamFileId"},{"$ref":"#/definitions/HostedEnvironmentFileParamInline"}],"description":"A file materialized in an OpenAI-hosted execution environment."},"ContainerSizeParam":{"type":"string","enum":["small","medium","large"],"description":"The CPU and memory tier for a new OpenAI-hosted session environment."},"InputContentParam":{"oneOf":[{"$ref":"#/definitions/InputContentParamInputText"},{"$ref":"#/definitions/InputContentParamInputImage"}],"description":"Content included in an input message."},"TextFormatParamText":{"type":"object","properties":{"type":{"type":"string","enum":["text"],"default":"text","description":"The type of the object. Always `text`."}},"required":["type"],"additionalProperties":false,"description":"Generates ordinary text without a structured-output constraint."},"TextFormatParamJsonSchema":{"type":"object","properties":{"type":{"type":"string","enum":["json_schema"],"default":"json_schema","description":"The type of the object. Always `json_schema`."},"schema":{"type":"object","additionalProperties":{},"propertyNames":{"type":"string","minLength":1,"maxLength":256},"minProperties":0,"maxProperties":1024,"description":"The JSON Schema that generated text must match."}},"required":["type","schema"],"additionalProperties":false,"description":"Constrains generated text to a JSON Schema."},"McpTransportConfigParam":{"oneOf":[{"$ref":"#/definitions/McpTransportConfigParamHttp"},{"$ref":"#/definitions/McpTransportConfigParamStdio"}],"description":"The transport used to connect to an MCP server."},"McpConnectionOriginParam":{"type":"string","enum":["service","environment"],"description":"Where outbound MCP HTTP connections originate."},"WebSearchModeParam":{"type":"string","enum":["disabled","cached","live"],"description":"The source used for web search results."},"WebSearchContextSizeParam":{"type":"string","enum":["low","medium","high"],"description":"The amount of web search context made available to the model."},"WebSearchLocationParam":{"type":"object","properties":{"country":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The two-letter ISO country code, such as `US`."},"region":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The region or state name."},"city":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The city name."},"timezone":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The IANA timezone, such as `America/Los_Angeles`."}},"additionalProperties":false,"description":"Approximate user location used to localize web search results."},"NetworkAccessParam":{"type":"string","enum":["enabled","disabled","restricted"],"description":"The network access mode for an OpenAI-hosted environment."},"HostedSkillParamSkillReference":{"type":"object","properties":{"type":{"type":"string","enum":["skill_reference"],"default":"skill_reference","description":"The type of the object. Always `skill_reference`."},"skill_id":{"type":"string","minLength":1,"maxLength":64,"description":"The ID of the skill created through `/v1/skills`."},"version":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The skill version, a positive integer or `latest`; omission selects the default."}},"required":["type","skill_id"],"additionalProperties":false,"description":"References a skill uploaded through the Skills API."},"HostedSkillParamInline":{"type":"object","properties":{"type":{"type":"string","enum":["inline"],"default":"inline","description":"The type of the object. Always `inline`."},"name":{"type":"string","minLength":1,"maxLength":64,"description":"The skill name declared in `SKILL.md`."},"description":{"type":"string","minLength":0,"maxLength":1048576,"description":"The skill description declared in `SKILL.md`."},"source":{"$ref":"#/definitions/InlineCapabilitySourceParam"}},"required":["type","name","description","source"],"additionalProperties":false,"description":"Supplies a skill ZIP directly in the session request."},"HostedPluginParamInline":{"type":"object","properties":{"type":{"type":"string","enum":["inline"],"default":"inline","description":"The type of the object. Always `inline`."},"name":{"type":"string","minLength":1,"maxLength":64,"description":"The plugin name declared in `.codex-plugin/plugin.json`."},"description":{"type":"string","minLength":0,"maxLength":1048576,"description":"The plugin description declared in `.codex-plugin/plugin.json`."},"source":{"$ref":"#/definitions/InlineCapabilitySourceParam"}},"required":["type","name","description","source"],"additionalProperties":false,"description":"Supplies a plugin ZIP directly in the session request."},"HostedEnvironmentFileParamFileId":{"type":"object","properties":{"type":{"type":"string","enum":["file_id"],"default":"file_id","description":"The type of the object. Always `file_id`."},"file_id":{"type":"string","minLength":1,"maxLength":256,"description":"The ID of the uploaded file."},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"The absolute destination path inside `/workspace`."}},"required":["type","file_id","path"],"additionalProperties":false,"description":"A file previously uploaded through the OpenAI Files API."},"HostedEnvironmentFileParamInline":{"type":"object","properties":{"type":{"type":"string","enum":["inline"],"default":"inline","description":"The type of the object. Always `inline`."},"data":{"type":"string","minLength":0,"maxLength":6990508,"description":"The standard-base64-encoded file contents."},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"The absolute destination path inside `/workspace`."}},"required":["type","data","path"],"additionalProperties":false,"description":"A file supplied directly as standard-base64 data."},"InputContentParamInputText":{"type":"object","properties":{"type":{"type":"string","enum":["input_text"],"default":"input_text","description":"The type of the object. Always `input_text`."},"text":{"type":"string","minLength":0,"maxLength":1048576,"description":"The text sent to the model."}},"required":["type","text"],"additionalProperties":false,"description":"Text input to the model."},"InputContentParamInputImage":{"type":"object","properties":{"type":{"type":"string","enum":["input_image"],"default":"input_image","description":"The type of the object. Always `input_image`."},"image_url":{"type":"string","minLength":0,"maxLength":1048576,"description":"The URL of the image sent to the model."}},"required":["type","image_url"],"additionalProperties":false,"description":"Image input to the model."},"McpTransportConfigParamHttp":{"type":"object","properties":{"type":{"type":"string","enum":["http"],"default":"http","description":"The type of the object. Always `http`."},"server_url":{"type":"string","minLength":0,"maxLength":1048576,"description":"The URL of the MCP server."},"authorization":{"type":["string","null"],"minLength":0,"maxLength":1048576,"description":"The authorization value sent to the MCP server, if any."},"headers":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":0,"maxLength":1048576},"propertyNames":{"type":"string","minLength":1,"maxLength":256},"minProperties":0,"maxProperties":1024,"description":"Additional HTTP headers sent to the MCP server."}},"required":["type","server_url"],"additionalProperties":false,"description":"Connects to an MCP server over HTTP."},"McpTransportConfigParamStdio":{"type":"object","properties":{"type":{"type":"string","enum":["stdio"],"default":"stdio","description":"The type of the object. Always `stdio`."},"command":{"type":"string","minLength":0,"maxLength":1048576,"description":"The command used to start the MCP server."},"args":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Arguments passed to the MCP server command."},"cwd":{"type":"string","minLength":0,"maxLength":1048576,"description":"The working directory used to start the MCP server."},"env":{"type":["object","null"],"additionalProperties":{"type":"string","minLength":0,"maxLength":1048576},"propertyNames":{"type":"string","minLength":1,"maxLength":256},"minProperties":0,"maxProperties":1024,"description":"Environment variables set for the MCP server process."},"env_vars":{"type":["array","null"],"items":{"type":"string","minLength":0,"maxLength":1048576},"minItems":0,"maxItems":16384,"description":"Environment variable names to inherit from the selected execution environment."}},"required":["type","command","cwd"],"additionalProperties":false,"description":"Starts an MCP server as a local process."},"InlineCapabilitySourceParam":{"oneOf":[{"$ref":"#/definitions/InlineCapabilitySourceParamBase64"}],"description":"The encoded ZIP archive for an inline skill or plugin."},"InlineCapabilitySourceParamBase64":{"type":"object","properties":{"type":{"type":"string","enum":["base64"],"default":"base64","description":"The type of the object. Always `base64`."},"media_type":{"type":"string","enum":["application/zip"],"default":"application/zip","description":"The archive media type, always `application/zip`."},"data":{"type":"string","minLength":1,"maxLength":70254592,"description":"Standard-base64 encoded ZIP archive bytes."}},"required":["type","media_type","data"],"additionalProperties":false,"description":"Provides ZIP bytes encoded with standard base64."}}},"name":"Create an agent session","id":"openai.createagentsession","example":{},"maxRequests":1,"summary":false}}