Lifecycle

curl -X POST "https://app.runtm.com/api/cloud/sessions/9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11/pause" \
  -H "Authorization: Bearer runtm_xxx"

import requests

session_id = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11"
response = requests.post(
    f"https://app.runtm.com/api/cloud/sessions/{session_id}/pause",
    headers={"Authorization": "Bearer runtm_xxx"},
)
print(response.json())

const sessionId = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11";
const res = await fetch(
  `https://app.runtm.com/api/cloud/sessions/${sessionId}/pause`,
  { method: "POST", headers: { Authorization: "Bearer runtm_xxx" } },
);
console.log(await res.json());

{
  "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
  "paused_at": "2026-05-09T15:30:00Z",
  "message": "Session paused successfully"
}

{ "detail": "Can only pause running sessions (state: paused)" }

{ "detail": "Cannot pause while a prompt is running" }

{ "detail": "Sandbox has expired. Please create a new session." }

curl -X POST "https://app.runtm.com/api/cloud/sessions/9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11/resume" \
  -H "Authorization: Bearer runtm_xxx"

import requests

session_id = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11"
response = requests.post(
    f"https://app.runtm.com/api/cloud/sessions/{session_id}/resume",
    headers={"Authorization": "Bearer runtm_xxx"},
)
print(response.json())

const sessionId = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11";
const res = await fetch(
  `https://app.runtm.com/api/cloud/sessions/${sessionId}/resume`,
  { method: "POST", headers: { Authorization: "Bearer runtm_xxx" } },
);
console.log(await res.json());

{
  "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
  "resumed_at": "2026-05-09T15:32:11Z",
  "message": "Session resumed successfully"
}

{ "detail": "Can only resume paused sessions (state: running)" }

{ "detail": "Session not found" }

curl -X POST "https://app.runtm.com/api/cloud/sessions/9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11/start" \
  -H "Authorization: Bearer runtm_xxx"

import requests

session_id = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11"
response = requests.post(
    f"https://app.runtm.com/api/cloud/sessions/{session_id}/start",
    headers={"Authorization": "Bearer runtm_xxx"},
)
data = response.json()
print(f"{data['state']} preview={data.get('preview_url')}")

const sessionId = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11";
const res = await fetch(
  `https://app.runtm.com/api/cloud/sessions/${sessionId}/start`,
  { method: "POST", headers: { Authorization: "Bearer runtm_xxx" } },
);
const data = await res.json();
console.log(data.state, data.preview_url);

{
  "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
  "state": "running",
  "preview_url": "https://3000-9f3a3f22.proxy.runtm.com",
  "port": 3000,
  "project_type": "node",
  "framework": "next",
  "server_ready": true,
  "message": null
}

{ "detail": "Session is no longer available" }

{ "detail": "Session is taking longer than expected to provision. Please try again." }

curl -X POST "https://app.runtm.com/api/cloud/sessions/cleanup" \
  -H "Authorization: Bearer runtm_xxx"

import requests

response = requests.post(
    "https://app.runtm.com/api/cloud/sessions/cleanup",
    headers={"Authorization": "Bearer runtm_xxx"},
)
print(response.json())

const res = await fetch("https://app.runtm.com/api/cloud/sessions/cleanup", {
  method: "POST",
  headers: { Authorization: "Bearer runtm_xxx" },
});
console.log(await res.json());

{
  "destroyed_count": 3,
  "warned_count": 5,
  "message": "Warned 5, destroyed 3 sessions"
}

{ "detail": "Invalid or expired API key" }