Daytona · JSON Structure

Daytona Snapshot Structure

JSON Structure for the Daytona Snapshot resource. Derived from the official Daytona OpenAPI specification at https://www.daytona.io/docs/openapi.json.

Type: object Properties: 20 Required: 14

AIAgentsArtificial IntelligenceCloudCode ExecutionComputer UseDeveloper ToolsInfrastructureOpen SourceSandboxSecure Execution

daytona-snapshot is a JSON Structure definition published by Daytona, describing 20 properties, of which 14 are required. It conforms to the https://json-structure.org/v0.1/schema meta-schema.

Properties

id organizationId general name imageName state size entrypoint cpu gpu mem disk errorReason createdAt updatedAt lastUsedAt buildInfo regionIds initialRunnerId ref

Meta-schema: https://json-structure.org/v0.1/schema

JSON Structure

{
  "$schema": "https://json-structure.org/v0.1/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/daytona-io/refs/heads/main/json-structure/daytona-snapshot-structure.json",
  "name": "daytona-snapshot",
  "description": "JSON Structure for the Daytona Snapshot resource. Derived from the official Daytona OpenAPI specification at https://www.daytona.io/docs/openapi.json.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "organizationId": {
      "type": "string"
    },
    "general": {
      "type": "boolean"
    },
    "name": {
      "type": "string"
    },
    "imageName": {
      "type": "string"
    },
    "state": {
      "allOf": [
        {
          "type": "string",
          "enum": [
            "building",
            "pending",
            "pulling",
            "active",
            "inactive",
            "error",
            "build_failed",
            "removing"
          ]
        }
      ]
    },
    "size": {
      "type": "number",
      "nullable": true
    },
    "entrypoint": {
      "nullable": true,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cpu": {
      "type": "number"
    },
    "gpu": {
      "type": "number"
    },
    "mem": {
      "type": "number"
    },
    "disk": {
      "type": "number"
    },
    "errorReason": {
      "type": "string",
      "nullable": true
    },
    "createdAt": {
      "format": "date-time",
      "type": "string"
    },
    "updatedAt": {
      "format": "date-time",
      "type": "string"
    },
    "lastUsedAt": {
      "format": "date-time",
      "type": "string",
      "nullable": true
    },
    "buildInfo": {
      "description": "Build information for the snapshot",
      "allOf": [
        {
          "type": "object",
          "properties": {
            "dockerfileContent": {
              "type": "string",
              "description": "The Dockerfile content used for the build",
              "example": "FROM node:14\nWORKDIR /app\nCOPY . .\nRUN npm install\nCMD [\"npm\", \"start\"]"
            },
            "contextHashes": {
              "description": "The context hashes used for the build",
              "example": [
                "hash1",
                "hash2"
              ],
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "createdAt": {
              "format": "date-time",
              "type": "string",
              "description": "The creation timestamp"
            },
            "updatedAt": {
              "format": "date-time",
              "type": "string",
              "description": "The last update timestamp"
            },
            "snapshotRef": {
              "type": "string",
              "description": "The snapshot reference",
              "example": "daytonaio/sandbox:latest"
            }
          },
          "required": [
            "createdAt",
            "updatedAt",
            "snapshotRef"
          ]
        }
      ]
    },
    "regionIds": {
      "description": "IDs of regions where the snapshot is available",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "initialRunnerId": {
      "type": "string",
      "description": "The initial runner ID of the snapshot",
      "example": "runner123"
    },
    "ref": {
      "type": "string",
      "description": "The snapshot reference",
      "example": "daytonaio/sandbox:latest"
    }
  },
  "required": [
    "id",
    "general",
    "name",
    "state",
    "size",
    "entrypoint",
    "cpu",
    "gpu",
    "mem",
    "disk",
    "errorReason",
    "createdAt",
    "updatedAt",
    "lastUsedAt"
  ]
}