API Reference

Computers

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get computer status (TTL)

client.computers.retrieveStatus(stringid, RequestOptionsoptions?): ComputerRetrieveStatusResponse { id, auto_kill, created_at, 6 more }

GET/computers/{id}/status

Get current TTLs and last activity metadata for a computer session

ParametersExpand Collapse

id: string

ReturnsExpand Collapse

ComputerRetrieveStatusResponse { id, auto_kill, created_at, 6 more }

id?: string

auto_kill?: boolean

created_at?: string

expires_at?: string

idle_expires_at?: string

inactivity_timeout_seconds?: number

last_activity_at?: string

max_lifetime_seconds?: number

status?: string

Get computer status (TTL)

TypeScript

HTTP

TypeScript

Python

import Lightcone from '@tzafon/lightcone';

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

const response = await client.computers.retrieveStatus('id');

console.log(response.id);

200 example

{
  "id": "id",
  "auto_kill": true,
  "created_at": "created_at",
  "expires_at": "expires_at",
  "idle_expires_at": "idle_expires_at",
  "inactivity_timeout_seconds": 0,
  "last_activity_at": "last_activity_at",
  "max_lifetime_seconds": 0,
  "status": "status"
}

Returns Examples

200 example

{
  "id": "id",
  "auto_kill": true,
  "created_at": "created_at",
  "expires_at": "expires_at",
  "idle_expires_at": "idle_expires_at",
  "inactivity_timeout_seconds": 0,
  "last_activity_at": "last_activity_at",
  "max_lifetime_seconds": 0,
  "status": "status"
}