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
integer
default:"20"
Number of results to return (1–100).
integer
default:"0"
Number of results to skip for pagination.
string
Filter by session state:
active, paused, destroyed.string
Filter by coding agent:
claude-code, codex, cursor, gemini, etc.string
Filter by template ID.
string
Filter by visibility:
private or team.Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization’s sessions.
Response
array
Array of session objects.
integer
Total number of matching sessions.
boolean
Whether more results exist beyond the current page.
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
}