veryfront__start_sandbox_background_commandAccess
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. |
command | string | Yes | Provide the command. Minimum length: 1. |
cwd | string | No | Provide the cwd. |
timeout_seconds | integer | No | Provide the timeout seconds. Default: 600. Maximum: 600. |
env | object | No | Provide the env. |
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__start_sandbox_background_command",
"arguments": {
"sandbox_id": "00000000-0000-4000-8000-000000000000",
"command": "example"
}
}
}
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 |
|---|---|---|---|
command_id | string | Yes | |
command | string | Yes | |
signal | string or null | Yes | |
heartbeat_status | string | Yes | Values: "disabled", "healthy", "degraded". |
last_heartbeat_at | string or null | Yes | |
last_heartbeat_error | string or null | Yes | |
heartbeat_failure_count | integer | Yes | Minimum: 0. |
status | string | Yes | Lifecycle status for the returned record. Values: "pending", "running", "completed", "failed", "canceled". |
exit_code | integer or null | Yes | |
started_at | string or null | Yes | |
finished_at | string or null | Yes |
Full schemas
{
"type": "object",
"properties": {
"sandbox_id": {
"type": "string",
"format": "uuid",
"description": "Sandbox UUID, as returned by createSandbox."
},
"command": {
"type": "string",
"minLength": 1,
"description": "Provide the command."
},
"cwd": {
"type": "string",
"description": "Provide the cwd."
},
"timeout_seconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 600,
"description": "Provide the timeout seconds.",
"default": 600
},
"env": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "Additional structured values supplied to the tool."
},
"description": "Provide the env."
}
},
"required": [
"sandbox_id",
"command"
],
"additionalProperties": false,
"description": "Arguments for the start_sandbox_background_command tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"command_id": {
"type": "string"
},
"command": {
"type": "string"
},
"signal": {
"type": [
"string",
"null"
]
},
"heartbeat_status": {
"type": "string",
"enum": [
"disabled",
"healthy",
"degraded"
]
},
"last_heartbeat_at": {
"type": [
"string",
"null"
]
},
"last_heartbeat_error": {
"type": [
"string",
"null"
]
},
"heartbeat_failure_count": {
"type": "integer",
"minimum": 0
},
"status": {
"type": "string",
"enum": [
"pending",
"running",
"completed",
"failed",
"canceled"
],
"description": "Lifecycle status for the returned record."
},
"exit_code": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null",
"description": "The exit code returned by the tool."
}
]
},
"started_at": {
"type": [
"string",
"null"
]
},
"finished_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"command_id",
"command",
"signal",
"heartbeat_status",
"last_heartbeat_at",
"last_heartbeat_error",
"heartbeat_failure_count",
"status",
"exit_code",
"started_at",
"finished_at"
],
"additionalProperties": false,
"description": "Structured result returned by the start_sandbox_background_command tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}