Manage Sessions

curl -X GET "https://app.runtm.com/api/cloud/sessions?limit=20&offset=0" \
  -H "Authorization: Bearer runtm_xxx"

import requests

response = requests.get(
    "https://app.runtm.com/api/cloud/sessions",
    headers={"Authorization": "Bearer runtm_xxx"},
    params={"limit": 20, "offset": 0},
)

data = response.json()
for s in data["sessions"]:
    print(f"{s['id']} {s['state']} {s.get('name')}")

const res = await fetch(
  "https://app.runtm.com/api/cloud/sessions?limit=20&offset=0",
  { headers: { Authorization: "Bearer runtm_xxx" } },
);
const data = await res.json();
data.sessions.forEach((s) => console.log(s.id, s.state, s.name));

{
  "sessions": [
    {
      "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
      "state": "running",
      "agent": "claude-code",
      "template": "web-app",
      "preview_url": "https://3000-9f3a3f22.proxy.runtm.com",
      "name": "Refactor checkout page",
      "created_at": "2026-05-09T15:03:11Z",
      "updated_at": "2026-05-09T15:18:54Z",
      "paused_at": null,
      "expires_at": null,
      "last_activity_at": "2026-05-09T15:18:54Z",
      "error_message": null,
      "github_repo": "acme/store",
      "total_cost_usd": 0.42,
      "prompt_count": 6,
      "visibility": "private",
      "organization_id": "org_01HZX...",
      "workspace_path": "/home/user/project",
      "source": "api",
      "idle_timeout_minutes": 30,
      "paused_expiry_days": null
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0,
  "has_more": false
}

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

curl -X POST "https://app.runtm.com/api/cloud/sessions" \
  -H "Authorization: Bearer runtm_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "claude-code",
    "mode": "autopilot",
    "github_repo": { "full_name": "acme/store", "branch": "main" },
    "source": "api",
    "ttl_minutes": 60
  }'

import requests

response = requests.post(
    "https://app.runtm.com/api/cloud/sessions",
    headers={"Authorization": "Bearer runtm_xxx"},
    json={
        "agent": "claude-code",
        "mode": "autopilot",
        "github_repo": {"full_name": "acme/store", "branch": "main"},
        "source": "api",
        "ttl_minutes": 60,
    },
)
data = response.json()
print(f"Created session {data['id']} (state: {data['state']})")

const res = await fetch("https://app.runtm.com/api/cloud/sessions", {
  method: "POST",
  headers: {
    Authorization: "Bearer runtm_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    agent: "claude-code",
    mode: "autopilot",
    github_repo: { full_name: "acme/store", branch: "main" },
    source: "api",
    ttl_minutes: 60,
  }),
});
const data = await res.json();
console.log(`Created session ${data.id} (state: ${data.state})`);

{
  "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
  "state": "creating",
  "agent": "claude-code",
  "template": null,
  "created_at": "2026-05-09T15:03:11Z",
  "expires_at": "2026-05-09T16:03:11Z",
  "message": "Session created successfully",
  "workspace_path": "/home/user/project",
  "linked_repos": null
}

{ "detail": "Invalid mode: foo. Must be 'autopilot' or 'interactive'" }

{ "detail": "Anthropic API key required. Background agents need a configured API key to run." }

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

import requests

session_id = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11"
response = requests.get(
    f"https://app.runtm.com/api/cloud/sessions/{session_id}",
    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}`,
  { headers: { Authorization: "Bearer runtm_xxx" } },
);
console.log(await res.json());

{
  "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
  "state": "running",
  "agent": "claude-code",
  "template": "web-app",
  "preview_url": "https://3000-9f3a3f22.proxy.runtm.com",
  "name": "Refactor checkout page",
  "created_at": "2026-05-09T15:03:11Z",
  "updated_at": "2026-05-09T15:18:54Z",
  "paused_at": null,
  "last_activity_at": "2026-05-09T15:18:54Z",
  "github_repo": "acme/store",
  "total_cost_usd": 0.42,
  "prompt_count": 6,
  "visibility": "private",
  "organization_id": "org_01HZX...",
  "workspace_path": "/home/user/project",
  "idle_timeout_minutes": 30,
  "last_prompt": {
    "status": "completed",
    "model": "sonnet",
    "started_at": "2026-05-09T15:18:31Z",
    "completed_at": "2026-05-09T15:18:54Z",
    "cost_usd": 0.07
  }
}

{ "detail": "Session not found" }

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

import requests

session_id = "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11"
response = requests.delete(
    f"https://app.runtm.com/api/cloud/sessions/{session_id}",
    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}`,
  { method: "DELETE", headers: { Authorization: "Bearer runtm_xxx" } },
);
console.log(await res.json());

{
  "id": "9f3a3f22-1d4e-4a9a-9a1f-3e5c6b1a0c11",
  "destroyed_at": "2026-05-09T16:00:01Z",
  "message": "Session destroyed successfully"
}

{ "detail": "You do not have permission to destroy this session" }

{ "detail": "Session not found" }