curl "https://app.runtm.com/api/cloud/v1/agents?can_launch=true" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents list
runtm-api agents list --can-launch
[
{
"id": "a1b2c3d4-0000-0000-0000-000000000000",
"organization_id": "org_abc123",
"name": "Donna",
"description": "GTM research agent",
"avatar": {"kind": "icon", "icon": "bot", "color": "blue"},
"avatar_image_url": null,
"system_instructions": "Be terse. Prefer PRs over prose.",
"default_template": "gtm-machine",
"default_agent": "claude-code",
"evaluator_criteria": {"version": 2, "objective": "Ship weekly lists", "checks": ["lists posted"]},
"economics": {"budget": {"monthly_usd_cap": 50}}
}
]
Agents
List Agents
List the organization’s roster agents
GET
/
api
/
v1
/
agents
curl "https://app.runtm.com/api/cloud/v1/agents?can_launch=true" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents list
runtm-api agents list --can-launch
[
{
"id": "a1b2c3d4-0000-0000-0000-000000000000",
"organization_id": "org_abc123",
"name": "Donna",
"description": "GTM research agent",
"avatar": {"kind": "icon", "icon": "bot", "color": "blue"},
"avatar_image_url": null,
"system_instructions": "Be terse. Prefer PRs over prose.",
"default_template": "gtm-machine",
"default_agent": "claude-code",
"evaluator_criteria": {"version": 2, "objective": "Ship weekly lists", "checks": ["lists posted"]},
"economics": {"budget": {"monthly_usd_cap": 50}}
}
]
Returns every agent in the active organization as a JSON array. The list lazily syncs rows from trigger integrations that carry a
config.agent_id, so agents created through the dashboard’s trigger flows appear here without a separate backfill.
The roster is visible to every member of the organization; can_launch and can_edit on each row say what this requester may do with it.
Required scope: activity:read
Query Parameters
boolean
true returns only the agents this caller may launch — the set you can pass to agent_id on a session create or launch. Omit it to get everything visible, including agents the caller may only edit.Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Organization ID. Omit for personal agents.
Response
A JSON array of agent objects.curl "https://app.runtm.com/api/cloud/v1/agents?can_launch=true" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents list
runtm-api agents list --can-launch
[
{
"id": "a1b2c3d4-0000-0000-0000-000000000000",
"organization_id": "org_abc123",
"name": "Donna",
"description": "GTM research agent",
"avatar": {"kind": "icon", "icon": "bot", "color": "blue"},
"avatar_image_url": null,
"system_instructions": "Be terse. Prefer PRs over prose.",
"default_template": "gtm-machine",
"default_agent": "claude-code",
"evaluator_criteria": {"version": 2, "objective": "Ship weekly lists", "checks": ["lists posted"]},
"economics": {"budget": {"monthly_usd_cap": 50}}
}
]