OpenAI · Schema

UpdateEnvironmentTemplateParams

Fields to replace on an existing reusable OpenAI-hosted environment template.

LLMOpenAIArtificial IntelligenceGenerative AIChatbotsFoundation ModelsT1

Properties

Name	Type	Description
name	stringnull	A replacement human-readable display name, or `null` to clear the name.
packages	object	Packages installed before the runtime network policy applies.
setup_commands	arraynull	Replacement confidential setup commands, never included in returned resources.
network	object	Network access available after setup completes. Omit to preserve the current policy, or pass `null` to reset to disabled for GA requests or enabled for alpha/beta requests.
env	objectnull	Replacement confidential environment values.
capability_directories	arraynull	Directories that expose capabilities to the agent.
skills	arraynull	Replacement skill configuration installed for each new session.
plugins	arraynull	Replacement plugin configuration installed for each new session.
files	arraynull	Replacement file configuration materialized for each new session.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/openai/main/json-schema/openai-update-environment-template-params-schema.json",
  "title": "UpdateEnvironmentTemplateParams",
  "description": "Fields to replace on an existing reusable OpenAI-hosted environment template.",
  "x-generated": "2026-09-23",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openai-agents-api-openapi.yml#/components/schemas/UpdateEnvironmentTemplateParams",
  "type": "object",
  "properties": {
    "name": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "maxLength": 256,
      "description": "A replacement human-readable display name, or `null` to clear the name."
    },
    "packages": {
      "anyOf": [
        {
          "$ref": "#/$defs/EnvironmentPackagesParam"
        },
        {
          "type": "null"
        }
      ],
      "description": "Packages installed before the runtime network policy applies."
    },
    "setup_commands": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/SetupCommandParam"
      },
      "minItems": 0,
      "maxItems": 16,
      "description": "Replacement confidential setup commands, never included in returned resources."
    },
    "network": {
      "anyOf": [
        {
          "$ref": "#/$defs/NetworkPolicyParam"
        },
        {
          "type": "null"
        }
      ],
      "description": "Network access available after setup completes. Omit to preserve the current policy, or pass `null` to reset to disabled for GA requests or enabled for alpha/beta requests."
    },
    "env": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": "string",
        "minLength": 0,
        "maxLength": 1048576
      },
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256
      },
      "minProperties": 0,
      "maxProperties": 1024,
      "description": "Replacement confidential environment values."
    },
    "capability_directories": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 1048576
      },
      "minItems": 0,
      "maxItems": 16384,
      "description": "Directories that expose capabilities to the agent."
    },
    "skills": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/HostedSkillParam"
      },
      "minItems": 0,
      "maxItems": 200,
      "description": "Replacement skill configuration installed for each new session."
    },
    "plugins": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/HostedPluginParam"
      },
      "minItems": 0,
      "maxItems": 32,
      "description": "Replacement plugin configuration installed for each new session."
    },
    "files": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/HostedEnvironmentFileParam"
      },
      "minItems": 0,
      "maxItems": 50,
      "description": "Replacement file configuration materialized for each new session."
    }
  },
  "additionalProperties": false,
  "$defs": {
    "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."
    },
    "HostedEnvironmentFileParam": {
      "oneOf": [
        {
          "$ref": "#/$defs/HostedEnvironmentFileParamFileId"
        },
        {
          "$ref": "#/$defs/HostedEnvironmentFileParamInline"
        }
      ],
      "x-oai-discriminator-values": [
        "file_id",
        "inline"
      ],
      "description": "A file materialized in an OpenAI-hosted execution environment."
    },
    "HostedEnvironmentFileParamFileId": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "file_id"
          ],
          "default": "file_id",
          "x-stainless-const": true,
          "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",
          "x-stainless-const": true,
          "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."
    },
    "HostedPluginParam": {
      "oneOf": [
        {
          "$ref": "#/$defs/HostedPluginParamInline"
        }
      ],
      "x-oai-discriminator-values": [
        "inline"
      ],
      "description": "A plugin installed in an OpenAI-hosted environment."
    },
    "HostedPluginParamInline": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "inline"
          ],
          "default": "inline",
          "x-stainless-const": true,
          "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": "#/$defs/InlineCapabilitySourceParam",
          "description": "The inline ZIP archive."
        }
      },
      "required": [
        "type",
        "name",
        "description",
        "source"
      ],
      "additionalProperties": false,
      "description": "Supplies a plugin ZIP directly in the session request."
    },
    "HostedSkillParam": {
      "oneOf": [
        {
          "$ref": "#/$defs/HostedSkillParamSkillReference"
        },
        {
          "$ref": "#/$defs/HostedSkillParamInline"
        }
      ],
      "x-oai-discriminator-values": [
        "skill_reference",
        "inline"
      ],
      "description": "A skill installed in an OpenAI-hosted environment."
    },
    "HostedSkillParamInline": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "inline"
          ],
          "default": "inline",
          "x-stainless-const": true,
          "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": "#/$defs/InlineCapabilitySourceParam",
          "description": "The inline ZIP archive."
        }
      },
      "required": [
        "type",
        "name",
        "description",
        "source"
      ],
      "additionalProperties": false,
      "description": "Supplies a skill ZIP directly in the session request."
    },
    "HostedSkillParamSkillReference": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "skill_reference"
          ],
          "default": "skill_reference",
          "x-stainless-const": true,
          "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."
    },
    "InlineCapabilitySourceParam": {
      "oneOf": [
        {
          "$ref": "#/$defs/InlineCapabilitySourceParamBase64"
        }
      ],
      "x-oai-discriminator-values": [
        "base64"
      ],
      "description": "The encoded ZIP archive for an inline skill or plugin."
    },
    "InlineCapabilitySourceParamBase64": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "base64"
          ],
          "default": "base64",
          "x-stainless-const": true,
          "description": "The type of the object. Always `base64`."
        },
        "media_type": {
          "type": "string",
          "enum": [
            "application/zip"
          ],
          "default": "application/zip",
          "x-stainless-const": true,
          "x-enumDescriptions": [
            "A ZIP archive."
          ],
          "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."
    },
    "NetworkAccessParam": {
      "type": "string",
      "enum": [
        "enabled",
        "disabled",
        "restricted"
      ],
      "x-enumDescriptions": [
        "Allows unrestricted network access.",
        "Disables network access.",
        "Allows access only to configured domains."
      ],
      "description": "The network access mode for an OpenAI-hosted environment."
    },
    "NetworkPolicyParam": {
      "type": "object",
      "properties": {
        "access": {
          "$ref": "#/$defs/NetworkAccessParam",
          "description": "The environment's network access mode."
        },
        "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."
        }
      },
      "required": [
        "access"
      ],
      "additionalProperties": false,
      "description": "Network access for 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."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/openai-update-environment-template-params"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.