java/resources/containers/methods/create/index.md 2026-07-10 23:02 UTC to 2026-07-12 06:58 UTC

Create container

ContainerCreateResponse containers().create(ContainerCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

post /containers

Create Container

Parameters

• ContainerCreateParams params

  • String name

    Name of the container to create.

  • Optional<ExpiresAfter> expiresAfter

    Container expiration time in seconds relative to the 'anchor' time.

    • Anchor anchor

      Time anchor for the expiration time. Currently only 'last_active_at' is supported.

      • LAST_ACTIVE_AT("last_active_at")

    • long minutes

  • Optional<List<String>> fileIds

    IDs of files to copy to the container.

  • Optional<MemoryLimit> memoryLimit

    Optional memory limit for the container. Defaults to "1g".

    • _1G("1g")

    • _4G("4g")

    • _16G("16g")

    • _64G("64g")

  • Optional<NetworkPolicy> networkPolicy

    Network access policy for the container.

    • class ContainerNetworkPolicyDisabled:

      • JsonValue; type "disabled"constant

        Disable outbound network access. Always disabled.

        • DISABLED("disabled")

    • class ContainerNetworkPolicyAllowlist:

      • List<String> allowedDomains

        A list of allowed domains when type is allowlist.

      • JsonValue; type "allowlist"constant

        Allow outbound network access only to specified domains. Always allowlist.

        • ALLOWLIST("allowlist")

      • Optional<List<ContainerNetworkPolicyDomainSecret>> domainSecrets

        Optional domain-scoped secrets for allowlisted domains.

        • String domain

          The domain associated with the secret.

        • String name

          The name of the secret to inject for the domain.

        • String value

          The secret value to inject for the domain.

  • Optional<List<Skill>> skills

    An optional list of skills referenced by id or inline data.

    • class SkillReference:

      • String skillId

        The ID of the referenced skill.

      • JsonValue; type "skill_reference"constant

        References a skill created with the /v1/skills endpoint.

        • SKILL_REFERENCE("skill_reference")

      • Optional<String> version

        Optional skill version. Use a positive integer or 'latest'. Omit for default.

    • class InlineSkill:

      • String description

        The description of the skill.

      • String name

        The name of the skill.

      • InlineSkillSource source

        Inline skill payload

        • String data

          Base64-encoded skill zip bundle.

        • JsonValue; mediaType "application/zip"constant

          The media type of the inline skill payload. Must be application/zip.

          • APPLICATION_ZIP("application/zip")

        • JsonValue; type "base64"constant

          The type of the inline skill source. Must be base64.

          • BASE64("base64")

      • JsonValue; type "inline"constant

        Defines an inline skill for this request.

        • INLINE("inline")

Returns

• class ContainerCreateResponse:

  • String id

    Unique identifier for the container.

  • long createdAt

    Unix timestamp (in seconds) when the container was created.

  • String name

    Name of the container.

  • String object_

    The type of this object.

  • String status

    Status of the container (e.g., active, deleted).

  • Optional<ExpiresAfter> expiresAfter

    The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.

    • Optional<Anchor> anchor

      The reference point for the expiration.

      • LAST_ACTIVE_AT("last_active_at")

    • Optional<Long> minutes

      The number of minutes after the anchor before the container expires.

  • Optional<Long> lastActiveAt

    Unix timestamp (in seconds) when the container was last active.

  • Optional<MemoryLimit> memoryLimit

    The memory limit configured for the container.

    • _1G("1g")

    • _4G("4g")

    • _16G("16g")

    • _64G("64g")

  • Optional<NetworkPolicy> networkPolicy

    Network access policy for the container.

    • Type type

      The network policy mode.

      • ALLOWLIST("allowlist")

      • DISABLED("disabled")

    • Optional<List<String>> allowedDomains

      Allowed outbound domains when type is allowlist.

Example

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.containers.ContainerCreateParams;
import com.openai.models.containers.ContainerCreateResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        ContainerCreateParams params = ContainerCreateParams.builder()
            .name("name")
            .build();
        ContainerCreateResponse container = client.containers().create(params);
    }
}

Response

{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "object",
  "status": "status",
  "expires_after": {
    "anchor": "last_active_at",
    "minutes": 0
  },
  "last_active_at": 0,
  "memory_limit": "1g",
  "network_policy": {
    "type": "allowlist",
    "allowed_domains": [
      "string"
    ]
  }
}