{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-create-schema.json",
  "title": "Create sandbox request",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/codai-ro-sandboxes-api-openapi.yml#/components/schemas/SandboxCreate",
  "type": "object",
  "properties": {
    "backend": {
      "type": "string",
      "enum": [
        "v1",
        "v2"
      ],
      "default": "v2",
      "description": "Execution backend: `v2` (default: long-lived pod with memory snapshots, pause/resume, fork, persistent kernel, preview URLs, egress through the codai proxy, Node 24 + npm) or `v1` (Cloud Run, workspace restored per exec, `POST /snapshot`). When omitted and v2 is not available for the key, the sandbox is created on `v1`; an explicit `v2` fails instead."
    },
    "template": {
      "type": "string",
      "enum": [
        "codai-base",
        "brivio-acte",
        "desktop"
      ],
      "default": "codai-base",
      "description": "Image template. `v1`: `codai-base` only. `v2`: `codai-base`, `brivio-acte` (office toolchain warmed up) or `desktop` (a Linux desktop over noVNC on port 6080)."
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 604800,
      "default": 3600,
      "description": "Lifetime; the sandbox expires afterwards (sliding for chat sessions). At most 86400 on `v1` and 604800 on `v2`."
    },
    "egress": {
      "$ref": "#/$defs/SandboxEgress"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Your own labels, returned as-is."
    }
  },
  "$defs": {
    "SandboxEgress": {
      "title": "Sandbox egress policy",
      "description": "Outbound network, on both backends. `none` (default) has no network at all; `allowlist` lets HTTPS reach at most 20 domains through the codai egress proxy (no IP literals, no internal hosts); `preset` opens a curated list (`pypi`, `npm`). The proxy opens plain tunnels and never injects credentials; v2 forks inherit the parent policy.",
      "oneOf": [
        {
          "type": "object",
          "title": "No network",
          "required": [
            "mode"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "none"
              ]
            }
          }
        },
        {
          "type": "object",
          "title": "Domain allowlist",
          "required": [
            "mode",
            "domains"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "allowlist"
              ]
            },
            "domains": {
              "type": "array",
              "minItems": 1,
              "maxItems": 20,
              "items": {
                "type": "string",
                "maxLength": 253
              },
              "description": "Host names, e.g. `api.anaf.ro`."
            }
          }
        },
        {
          "type": "object",
          "title": "Preset",
          "required": [
            "mode",
            "preset"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "preset"
              ]
            },
            "preset": {
              "type": "string",
              "enum": [
                "pypi",
                "npm"
              ]
            }
          }
        }
      ]
    }
  }
}