Skip to main content
Update the lifetime policy for a sandbox session.

Tool details

FieldValue
Nameupdate_sandbox_session_lifetime
GroupSandbox

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Sandbox session ID."
    },
    "ttl_mode": {
      "type": "string",
      "enum": [
        "default",
        "duration",
        "always_on"
      ],
      "description": "Sandbox lifetime policy. default uses platform cleanup policy."
    },
    "ttl_hours": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 24,
      "description": "Required when ttl_mode is duration. Maximum 24 hours."
    }
  },
  "required": [
    "id",
    "ttl_mode"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Input schema for the update_sandbox_session_lifetime tool."
}

Output schema

Output schema
{
  "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 update_sandbox_session_lifetime tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}