curl "https://app.runtm.com/api/cloud/sessions?limit=10&state=active" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/sessions",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
params={"limit": 10, "state": "active"},
)
data = response.json()
for s in data["sessions"]:
print(f"{s['id']} - {s['name']} ({s['state']})")
const params = new URLSearchParams({ limit: "10", state: "active" });
const response = await fetch(
`https://app.runtm.com/api/cloud/sessions?${params}`,
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
data.sessions.forEach((s) =>
console.log(`${s.id} - ${s.name} (${s.state})`)
);
{
"sessions": [
{
"id": "ses_abc123",
"name": "API refactor",
"state": "active",
"agent": "claude-code",
"template_id": "tpl_xyz",
"sandbox_url": "https://ses-abc123.runtm.dev",
"visibility": "team",
"user_id": "user_xyz",
"organization_id": "org_abc123",
"created_at": "2026-05-09T10:00:00Z",
"updated_at": "2026-05-09T12:30:00Z"
}
],
"total": 1,
"has_more": false
}
Sessions
List Sessions
List cloud sessions with pagination and filters
GET
/
api
/
sessions
curl "https://app.runtm.com/api/cloud/sessions?limit=10&state=active" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/sessions",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
params={"limit": 10, "state": "active"},
)
data = response.json()
for s in data["sessions"]:
print(f"{s['id']} - {s['name']} ({s['state']})")
const params = new URLSearchParams({ limit: "10", state: "active" });
const response = await fetch(
`https://app.runtm.com/api/cloud/sessions?${params}`,
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
data.sessions.forEach((s) =>
console.log(`${s.id} - ${s.name} (${s.state})`)
);
{
"sessions": [
{
"id": "ses_abc123",
"name": "API refactor",
"state": "active",
"agent": "claude-code",
"template_id": "tpl_xyz",
"sandbox_url": "https://ses-abc123.runtm.dev",
"visibility": "team",
"user_id": "user_xyz",
"organization_id": "org_abc123",
"created_at": "2026-05-09T10:00:00Z",
"updated_at": "2026-05-09T12:30:00Z"
}
],
"total": 1,
"has_more": false
}
Returns a paginated list of cloud sessions. Filter by state, agent, template, or visibility.
Required scope:
sessions:read
Query Parameters
Headers
Response
curl "https://app.runtm.com/api/cloud/sessions?limit=10&state=active" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
response = requests.get(
"https://app.runtm.com/api/cloud/sessions",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
params={"limit": 10, "state": "active"},
)
data = response.json()
for s in data["sessions"]:
print(f"{s['id']} - {s['name']} ({s['state']})")
const params = new URLSearchParams({ limit: "10", state: "active" });
const response = await fetch(
`https://app.runtm.com/api/cloud/sessions?${params}`,
{
headers: {
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await response.json();
data.sessions.forEach((s) =>
console.log(`${s.id} - ${s.name} (${s.state})`)
);
{
"sessions": [
{
"id": "ses_abc123",
"name": "API refactor",
"state": "active",
"agent": "claude-code",
"template_id": "tpl_xyz",
"sandbox_url": "https://ses-abc123.runtm.dev",
"visibility": "team",
"user_id": "user_xyz",
"organization_id": "org_abc123",
"created_at": "2026-05-09T10:00:00Z",
"updated_at": "2026-05-09T12:30:00Z"
}
],
"total": 1,
"has_more": false
}