Agents
Lists agents owned by your API key’s account (the same owner roster as the product UI). Use an agent’s public id (ag_…) as agentId when creating tasks or schedules.
Create and edit of agents is not part of this API. Internal agent UUIDs are never returned.
List
kobold-cli agents list
GET /v1/agents
Authorization: Bearer <api_key>
Success 200:
{
"agents": [
{
"id": "ag_7k2m9x4q",
"name": "Researcher",
"type": "",
"description": "…",
"capabilities": [],
"status": "active",
"imageUrl": ""
}
]
}
| Field | Notes |
|---|---|
id |
Public id (ag_…); lazy-minted on first list |
name |
Display name from the owner catalog |
description |
From the owner catalog |
imageUrl |
From the owner catalog |
type |
Always "" today (field reserved; not populated) |
capabilities |
Always [] today (field reserved; not populated) |
status |
Always "active" today |
Upstream catalog failure → 502.