veryfront__update_sandbox_lifetimeAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
sandbox_id | string | Yes | Sandbox UUID, as returned by createSandbox. Format: uuid. |
ttl_mode | string | Yes | Sandbox lifetime policy. default uses the platform’s idle and maximum lifetime limits. Values: "default", "duration", "always_on". |
ttl_hours | integer | No | Required when ttl_mode is duration. Number of hours before cleanup, up to 24. Maximum: 24. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__update_sandbox_lifetime",
"arguments": {
"sandbox_id": "00000000-0000-4000-8000-000000000000",
"ttl_mode": "default"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id | string | Yes | Unique identifier for the returned record. Format: uuid. |
short_id | string | Yes | |
endpoint | string | Yes | Sandbox endpoint URL. |
status | string | Yes | Sandbox lifecycle status. Values: "pending", "provisioning", "running", "error", "deleting". |
project_id | string or null | Yes | Project identifier associated with this result. |
run_id | string or null | No | Agent run that created this sandbox. |
stopped_at | string or null | No | Compute cleanup completed; only session history remains. |
access_scope | string | Yes | Values: "project", "private". |
workspace_storage | string | Yes | Persistent workspaces survive runtime pod replacement. Deleting the sandbox also deletes its workspace. Values: "ephemeral", "persistent". |
ttl_mode | string | Yes | Values: "default", "duration", "always_on". |
ttl_hours | integer or null | Yes | |
expires_at | string or null | Yes | |
created_at | string | Yes | Creation timestamp in ISO 8601 format. |
last_activity_at | string or null | Yes | |
variable_snapshot | object | No | Snapshot provenance on sandbox details. Variables are copied once, without live synchronization. No variable keys or values are included. |
Full schemas
{
"type": "object",
"properties": {
"sandbox_id": {
"type": "string",
"format": "uuid",
"description": "Sandbox UUID, as returned by createSandbox."
},
"ttl_mode": {
"type": "string",
"enum": [
"default",
"duration",
"always_on"
],
"description": "Sandbox lifetime policy. `default` uses the platform’s idle and maximum lifetime limits."
},
"ttl_hours": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 24,
"description": "Required when ttl_mode is duration. Number of hours before cleanup, up to 24."
}
},
"required": [
"sandbox_id",
"ttl_mode"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the update_sandbox_lifetime tool."
}
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the returned record."
},
"short_id": {
"type": "string"
},
"endpoint": {
"type": "string",
"description": "Sandbox endpoint URL."
},
"status": {
"type": "string",
"enum": [
"pending",
"provisioning",
"running",
"error",
"deleting"
],
"description": "Sandbox lifecycle status."
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
},
{
"type": "null",
"description": "Project identifier associated with this result."
}
],
"description": "Project identifier associated with this result."
},
"run_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Run identifier associated with this result."
},
{
"type": "null",
"description": "Run identifier associated with this result."
}
],
"description": "Agent run that created this sandbox."
},
"stopped_at": {
"type": [
"string",
"null"
],
"description": "Compute cleanup completed; only session history remains."
},
"access_scope": {
"type": "string",
"enum": [
"project",
"private"
]
},
"workspace_storage": {
"type": "string",
"enum": [
"ephemeral",
"persistent"
],
"description": "Persistent workspaces survive runtime pod replacement. Deleting the sandbox also deletes its workspace."
},
"ttl_mode": {
"type": "string",
"enum": [
"default",
"duration",
"always_on"
]
},
"ttl_hours": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0
},
{
"type": "null",
"description": "The ttl hours returned by the tool."
}
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"last_activity_at": {
"type": [
"string",
"null"
]
},
"variable_snapshot": {
"type": "object",
"properties": {
"source_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null",
"description": "The source environment id returned by the tool."
}
]
},
"variable_count": {
"type": "integer",
"minimum": 0
},
"copied_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"source_environment_id",
"variable_count",
"copied_at"
],
"additionalProperties": false,
"description": "Snapshot provenance on sandbox details. Variables are copied once, without live synchronization. No variable keys or values are included."
}
},
"required": [
"id",
"short_id",
"endpoint",
"status",
"project_id",
"access_scope",
"workspace_storage",
"ttl_mode",
"ttl_hours",
"expires_at",
"created_at",
"last_activity_at"
],
"additionalProperties": false,
"description": "Structured result returned by the update_sandbox_lifetime tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}