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

Create container

client.Containers.New(ctx, body) (*ContainerNewResponse, error)

post /containers

Create Container

Parameters

• body ContainerNewParams

  • Name param.Field[string]

    Name of the container to create.

  • ExpiresAfter param.Field[ContainerNewParamsExpiresAfter]

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

    • Anchor string

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

      • const ContainerNewParamsExpiresAfterAnchorLastActiveAt ContainerNewParamsExpiresAfterAnchor = "last_active_at"

    • Minutes int64

  • FileIDs param.Field[[]string]

    IDs of files to copy to the container.

  • MemoryLimit param.Field[ContainerNewParamsMemoryLimit]

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

    • const ContainerNewParamsMemoryLimit1g ContainerNewParamsMemoryLimit = "1g"

    • const ContainerNewParamsMemoryLimit4g ContainerNewParamsMemoryLimit = "4g"

    • const ContainerNewParamsMemoryLimit16g ContainerNewParamsMemoryLimit = "16g"

    • const ContainerNewParamsMemoryLimit64g ContainerNewParamsMemoryLimit = "64g"

  • NetworkPolicy param.Field[ContainerNewParamsNetworkPolicyUnion]

    Network access policy for the container.

    • type ContainerNetworkPolicyDisabled struct{…}

      • Type Disabled

        Disable outbound network access. Always disabled.

        • const DisabledDisabled Disabled = "disabled"

    • type ContainerNetworkPolicyAllowlist struct{…}

      • AllowedDomains []string

        A list of allowed domains when type is allowlist.

      • Type Allowlist

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

        • const AllowlistAllowlist Allowlist = "allowlist"

      • DomainSecrets []ContainerNetworkPolicyDomainSecret

        Optional domain-scoped secrets for allowlisted domains.

        • Domain string

          The domain associated with the secret.

        • Name string

          The name of the secret to inject for the domain.

        • Value string

          The secret value to inject for the domain.

  • Skills param.Field[[]ContainerNewParamsSkillUnion]

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

    • type SkillReference struct{…}

      • SkillID string

        The ID of the referenced skill.

      • Type SkillReference

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

        • const SkillReferenceSkillReference SkillReference = "skill_reference"

      • Version string

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

    • type InlineSkill struct{…}

      • Description string

        The description of the skill.

      • Name string

        The name of the skill.

      • Source InlineSkillSource

        Inline skill payload

        • Data string

          Base64-encoded skill zip bundle.

        • MediaType ApplicationZip

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

          • const ApplicationZipApplicationZip ApplicationZip = "application/zip"

        • Type Base64

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

          • const Base64Base64 Base64 = "base64"

      • Type Inline

        Defines an inline skill for this request.

        • const InlineInline Inline = "inline"

Returns

• type ContainerNewResponse struct{…}

  • ID string

    Unique identifier for the container.

  • CreatedAt int64

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

  • Name string

    Name of the container.

  • Object string

    The type of this object.

  • Status string

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

  • ExpiresAfter ContainerNewResponseExpiresAfter

    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.

    • Anchor string

      The reference point for the expiration.

      • const ContainerNewResponseExpiresAfterAnchorLastActiveAt ContainerNewResponseExpiresAfterAnchor = "last_active_at"

    • Minutes int64

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

  • LastActiveAt int64

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

  • MemoryLimit ContainerNewResponseMemoryLimit

    The memory limit configured for the container.

    • const ContainerNewResponseMemoryLimit1g ContainerNewResponseMemoryLimit = "1g"

    • const ContainerNewResponseMemoryLimit4g ContainerNewResponseMemoryLimit = "4g"

    • const ContainerNewResponseMemoryLimit16g ContainerNewResponseMemoryLimit = "16g"

    • const ContainerNewResponseMemoryLimit64g ContainerNewResponseMemoryLimit = "64g"

  • NetworkPolicy ContainerNewResponseNetworkPolicy

    Network access policy for the container.

    • Type string

      The network policy mode.

      • const ContainerNewResponseNetworkPolicyTypeAllowlist ContainerNewResponseNetworkPolicyType = "allowlist"

      • const ContainerNewResponseNetworkPolicyTypeDisabled ContainerNewResponseNetworkPolicyType = "disabled"

    • AllowedDomains []string

      Allowed outbound domains when type is allowlist.

Example

package main

import (
  "context"
  "fmt"

  "github.com/openai/openai-go"
  "github.com/openai/openai-go/option"
)

func main() {
  client := openai.NewClient(
    option.WithAPIKey("My API Key"),
  )
  container, err := client.Containers.New(context.TODO(), openai.ContainerNewParams{
    Name: "name",
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", container.ID)
}

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"
    ]
  }
}