Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Create an agent environment

beta.agents.environments.create(EnvironmentCreateParams**kwargs) -> EnvironmentInfo
POST/agents/environments

Creates an OpenAI-hosted environment before creating a session. Requires access to the prewarming beta.

ParametersExpand Collapse
environment: Environment

The required hosting type and its configuration.

vault_ids: Optional[Sequence[str]]

The IDs of up to 10 vaults made available to an OpenAI-hosted environment.

idempotency_key: Optional[str]
minLength1
maxLength256
ReturnsExpand Collapse
class EnvironmentInfo: …

Safe metadata for a first-class execution environment.

id: str

The ID of the environment.

minLength0
files: List[HostedEnvironmentFile]

Files installed in the environment, without their contents.

object: Literal["agent.environment"]

The object type. Always agent.environment.

plugins: List[HostedPlugin]

Plugins installed in the environment, without their archive contents.

skills: List[HostedSkill]

Skills installed in the environment, without their archive contents.

status: Literal["pending", "ready", "connected", 4 more]

The current environment connection status.

type: Literal["openai_hosted", "self_hosted"]

Whether the environment is hosted by OpenAI or by the application.

Create an agent environment

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
environment_info = client.beta.agents.environments.create(
    environment={
        "type": "openai_hosted"
    },
)
print(environment_info.id)
{
  "id": "id",
  "files": [
    {
      "id": "id",
      "file_id": "file_id",
      "path": "path",
      "size_bytes": 0,
      "type": "file_id"
    }
  ],
  "object": "agent.environment",
  "plugins": [
    {
      "description": "description",
      "name": "name",
      "type": "inline"
    }
  ],
  "skills": [
    {
      "description": "description",
      "name": "name",
      "skill_id": "skill_id",
      "type": "skill_reference",
      "version": "version"
    }
  ],
  "status": "pending",
  "type": "openai_hosted"
}
Returns Examples
{
  "id": "id",
  "files": [
    {
      "id": "id",
      "file_id": "file_id",
      "path": "path",
      "size_bytes": 0,
      "type": "file_id"
    }
  ],
  "object": "agent.environment",
  "plugins": [
    {
      "description": "description",
      "name": "name",
      "type": "inline"
    }
  ],
  "skills": [
    {
      "description": "description",
      "name": "name",
      "skill_id": "skill_id",
      "type": "skill_reference",
      "version": "version"
    }
  ],
  "status": "pending",
  "type": "openai_hosted"
}