curl "https://app.runtm.com/api/cloud/v1/agents/a1b2c3d4-0000-0000-0000-000000000000" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents get a1b2c3d4-0000-0000-0000-000000000000
{
"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.",
"default_template": "gtm-machine",
"default_agent": "claude-code",
"evaluator_criteria": {"version": 2, "objective": "Ship weekly lists", "checks": ["lists posted"]},
"economics": null
}
Agents
Get Agent
Get one roster agent
GET
/
api
/
v1
/
agents
/
{agent_id}
curl "https://app.runtm.com/api/cloud/v1/agents/a1b2c3d4-0000-0000-0000-000000000000" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents get a1b2c3d4-0000-0000-0000-000000000000
{
"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.",
"default_template": "gtm-machine",
"default_agent": "claude-code",
"evaluator_criteria": {"version": 2, "objective": "Ship weekly lists", "checks": ["lists posted"]},
"economics": null
}
Returns a single agent object. Agents outside the caller’s organization return
404.
Required scope: activity:read
Path Parameters
string
required
The agent ID.
Headers
string
required
Bearer token.
string
Organization ID. Omit for personal agents.
curl "https://app.runtm.com/api/cloud/v1/agents/a1b2c3d4-0000-0000-0000-000000000000" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents get a1b2c3d4-0000-0000-0000-000000000000
{
"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.",
"default_template": "gtm-machine",
"default_agent": "claude-code",
"evaluator_criteria": {"version": 2, "objective": "Ship weekly lists", "checks": ["lists posted"]},
"economics": null
}