Skip to main content
GET
/
agents
List agents
curl --request GET \
  --url https://www.dench.com/api/v1/agents \
  --header 'Authorization: Bearer <token>'
{
  "workspace": {
    "id": "org_abc123",
    "name": "Acme",
    "slug": "acme"
  },
  "agent": {
    "id": "ag_xyz789",
    "name": "Cursor",
    "kind": "cursor"
  },
  "rules": [],
  "activeAgents": [
    {
      "id": "ag_xyz789",
      "name": "Cursor",
      "kind": "cursor",
      "lastSeenAt": 1765526400000
    }
  ],
  "pendingApprovals": [],
  "recentArtifacts": [],
  "suggestedWork": [],
  "memory": [],
  "chatAgents": {
    "nextCommands": [
      "dench agent new \"Find useful work\" --follow --json"
    ],
    "activeRuns": [],
    "templates": []
  },
  "tools": {
    "discovery": [
      "dench_list_apps",
      "dench_search_tools"
    ],
    "cli": [
      "dench apps --json"
    ],
    "approvalPolicy": "Read-only tools can run by default."
  },
  "nextActions": [
    "Ask for a goal or start a chat agent"
  ]
}

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Response

Successful response

Workspace orientation payload shared by /context, /status, /agents, and /approvals.

workspace
object
required
agent
object
required
rules
object[]
required
activeAgents
object[]
required
pendingApprovals
object[]
required
recentArtifacts
object[]
required
suggestedWork
object[]
required
memory
object[]
required
chatAgents
object
required
tools
object
required
nextActions
string[]
required