Create sandbox session - Veryfront

Create an ephemeral sandbox execution environment. Claims a warm sandbox pod or creates a new one. Uses project_reference or the scoped MCP project when available.

Tool details

Field	Value
Name	`create_sandbox_session`
Group	Sandbox

Playground

Input schema

input-schema.json

{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Optional project UUID or slug - when set, the project owner is billed"
    },
    "environment_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optional environment ID. Copies that environment's variables once into the sandbox session."
    },
    "ttl_mode": {
      "type": "string",
      "enum": [
        "default",
        "duration",
        "always_on"
      ],
      "description": "Sandbox lifetime policy. default uses platform idle/max lifetime cleanup."
    },
    "ttl_hours": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 24,
      "description": "Required when ttl_mode is duration. Maximum 24 hours."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Input schema for the create_sandbox_session tool."
}

Output schema

output-schema.json

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the returned record."
    },
    "short_id": {
      "type": "string",
      "description": "The short id associated with this tool result."
    },
    "endpoint": {
      "type": "string",
      "description": "The endpoint associated with this tool result."
    },
    "status": {
      "type": "string",
      "description": "Lifecycle status for the returned record."
    },
    "ttl_mode": {
      "type": "string",
      "enum": [
        "default",
        "duration",
        "always_on"
      ],
      "description": "The ttl mode associated with this tool result."
    },
    "ttl_hours": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "The ttl hours associated with this tool result."
        },
        {
          "type": "null",
          "description": "The ttl hours returned by the tool."
        }
      ],
      "description": "The ttl hours associated with this tool result."
    },
    "expires_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "The expires at associated with this tool result."
    },
    "created_at": {
      "type": "string",
      "description": "Creation timestamp in ISO 8601 format."
    }
  },
  "required": [
    "id",
    "short_id",
    "endpoint",
    "status",
    "ttl_mode",
    "ttl_hours",
    "expires_at",
    "created_at"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the create_sandbox_session tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}