Skip to content
Lightcone Lightcone
NorthstarPlatformPricingLogin
API Reference
Computers

Create a new computer instance

client.computers.create(ComputerCreateParams { auto_kill, context_id, display, 9 more } body?, RequestOptionsoptions?): ComputerResponse { id, auto_kill, created_at, 9 more }
POST/computers

Create a new automation session. Set kind to "browser" for web automation or "desktop" for OS-level automation. Defaults to "browser" if not specified. max_lifetime_seconds controls max lifetime, inactivity_timeout_seconds controls idle timeout, and idle_timeout_enabled (default true) controls whether idle timeout is enforced (max lifetime always applies). The deprecated fields timeout_seconds and auto_kill are still accepted but will be removed after 2026-06-06.

ParametersExpand Collapse
body: ComputerCreateParams { auto_kill, context_id, display, 9 more }
auto_kill?: boolean

Deprecated: use idle_timeout_enabled

context_id?: string
display?: Display
height?: number
scale?: number
width?: number
environment_id?: string
idle_timeout_enabled?: boolean

If true (default), kill session after inactivity

inactivity_timeout_seconds?: number

Idle timeout before kill

kind?: string

"browser" (default) or "desktop"

max_lifetime_seconds?: number

Max session duration in seconds

persistent?: boolean

Persist cookies/storage state to DB on session teardown only if true

stealth?: unknown
timeout_seconds?: number

Deprecated: use max_lifetime_seconds

use_advanced_proxy?: boolean

If true (browser sessions), use ADVANCED_PROXY_URL on session start

ReturnsExpand Collapse
ComputerResponse { id, auto_kill, created_at, 9 more }
id?: string
auto_kill?: boolean

Deprecated: mirrors IdleTimeoutEnabled. Remove after 2026-06-06.

created_at?: string
endpoints?: Record<string, string>
expires_at?: string
idle_expires_at?: string
idle_timeout_enabled?: boolean
inactivity_timeout_seconds?: number
kind?: string
last_activity_at?: string
max_lifetime_seconds?: number
status?: string

Create a new computer instance

import Lightcone from '@tzafon/lightcone';

const client = new Lightcone({
  apiKey: process.env['TZAFON_API_KEY'], // This is the default and can be omitted
});

const computerResponse = await client.computers.create();

console.log(computerResponse.id);
{
  "id": "id",
  "auto_kill": true,
  "created_at": "created_at",
  "endpoints": {
    "foo": "string"
  },
  "expires_at": "expires_at",
  "idle_expires_at": "idle_expires_at",
  "idle_timeout_enabled": true,
  "inactivity_timeout_seconds": 0,
  "kind": "kind",
  "last_activity_at": "last_activity_at",
  "max_lifetime_seconds": 0,
  "status": "status"
}
Returns Examples
{
  "id": "id",
  "auto_kill": true,
  "created_at": "created_at",
  "endpoints": {
    "foo": "string"
  },
  "expires_at": "expires_at",
  "idle_expires_at": "idle_expires_at",
  "idle_timeout_enabled": true,
  "inactivity_timeout_seconds": 0,
  "kind": "kind",
  "last_activity_at": "last_activity_at",
  "max_lifetime_seconds": 0,
  "status": "status"
}