API Reference

Computers

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get computer status (TTL)

computers.retrieve_status(strid) -> ComputerRetrieveStatusResponse

GET/computers/{id}/status

Get current TTLs and last activity metadata for a computer session

ParametersExpand Collapse

id: str

ReturnsExpand Collapse

class ComputerRetrieveStatusResponse: …

id: Optional[str]

auto_kill: Optional[bool]

created_at: Optional[str]

expires_at: Optional[str]

idle_expires_at: Optional[str]

inactivity_timeout_seconds: Optional[int]

last_activity_at: Optional[str]

max_lifetime_seconds: Optional[int]

status: Optional[str]

Get computer status (TTL)

Python

HTTP

TypeScript

Python

import os
from tzafon import Lightcone

client = Lightcone(
    api_key=os.environ.get("TZAFON_API_KEY"),  # This is the default and can be omitted
)
response = client.computers.retrieve_status(
    "id",
)
print(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"
}