create_session
Start or reconnect to a remote Blender project session, restoring its last checkpoint and optionally choosing GPU, GUI/headless mode, or a new workspace.
Instructions
Start or reconnect to a project. GPU resources incur charges until stopped.
First creation builds a Blender image and can take several minutes. Existing
projects restore their last checkpoint. Set restore_revision to recover an older
checkpoint at startup if the latest one is unusable; stop any active session first.
new_workspace=true creates a new independent Blender/Sandbox/Volume, even for the
same project label. Returned workspace_id can reopen that exact workspace later.
Without either option, the default project workspace is reused. Agent spawning,
scheduling and aggregation are entirely the caller's responsibility.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project": "<project>"
},
"name": "create_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gpu | No | ||
| mode | No | headless | |
| project | Yes | ||
| idle_seconds | No | ||
| workspace_id | No | ||
| new_workspace | No | ||
| lifetime_seconds | No | ||
| restore_revision | No |