curl "https://app.runtm.com/api/cloud/sessions:search?q=outbound&agent=claude-code&limit=10" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session search -q outbound --agent claude-code --limit 10
runtm-api session search --template gtm-machine --created-after 2026-07-01 --team-mode
{
"sessions": [
{
"id": "a6414511-4430-4e1f-8c51-8ea8824dadec",
"state": "running",
"agent": "claude-code",
"template": "gtm-machine",
"name": "Weekly outbound lists",
"initial_prompt": "Build this week's outbound lists...",
"created_at": "2026-07-27T18:00:05Z",
"source": "schedule",
"visibility": "private"
}
],
"total": 1,
"limit": 10,
"offset": 0,
"has_more": false
}
Sessions
Search Sessions
Fuzzy-search sessions with filters
GET
/
api
/
sessions:search
curl "https://app.runtm.com/api/cloud/sessions:search?q=outbound&agent=claude-code&limit=10" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session search -q outbound --agent claude-code --limit 10
runtm-api session search --template gtm-machine --created-after 2026-07-01 --team-mode
{
"sessions": [
{
"id": "a6414511-4430-4e1f-8c51-8ea8824dadec",
"state": "running",
"agent": "claude-code",
"template": "gtm-machine",
"name": "Weekly outbound lists",
"initial_prompt": "Build this week's outbound lists...",
"created_at": "2026-07-27T18:00:05Z",
"source": "schedule",
"visibility": "private"
}
],
"total": 1,
"limit": 10,
"offset": 0,
"has_more": false
}
Searches sessions by text and structured filters. Where List Sessions only pages, search finds a session when you know something about it: a phrase from the prompt, the agent that ran it, the template it came from, or a time window.
Note the custom-method path: the verb is
:search appended to the collection, not a path segment.
Required scope: sessions:read
Query Parameters
string
Fuzzy substring match on session name and prompt text.
string[]
Filter by coding agent (repeatable).
string[]
Filter by model (repeatable).
string[]
Filter by template slug (repeatable).
string[]
Filter by source, for example
web_ui, agents, slack, schedule (repeatable).string[]
Filter by creator user ID (repeatable).
string
ISO date or datetime lower bound on creation.
string
ISO date or datetime upper bound on creation.
string
ISO lower bound on last activity.
string
ISO upper bound on last activity.
boolean
default:"false"
Include destroyed sessions.
boolean
default:"false"
Search team-shared sessions (requires organization context).
string
Comma-separated sources to exclude.
string
Comma-separated states to exclude.
integer
default:"20"
Results per page (1 to 100).
integer
default:"0"
Pagination offset.
Response
Same shape as List Sessions:{sessions, total, limit, offset, has_more}.
curl "https://app.runtm.com/api/cloud/sessions:search?q=outbound&agent=claude-code&limit=10" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session search -q outbound --agent claude-code --limit 10
runtm-api session search --template gtm-machine --created-after 2026-07-01 --team-mode
{
"sessions": [
{
"id": "a6414511-4430-4e1f-8c51-8ea8824dadec",
"state": "running",
"agent": "claude-code",
"template": "gtm-machine",
"name": "Weekly outbound lists",
"initial_prompt": "Build this week's outbound lists...",
"created_at": "2026-07-27T18:00:05Z",
"source": "schedule",
"visibility": "private"
}
],
"total": 1,
"limit": 10,
"offset": 0,
"has_more": false
}