> ## Documentation Index > Fetch the complete documentation index at: https://dench.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List agents > List agents visible in the workspace status payload. ## OpenAPI ````yaml /api-reference/openapi.json get /agents openapi: 3.1.0 info: title: Dench API version: 1.0.0 description: >- Versioned Dench workspace API. The operation registry is shared with the Dench CLI parity layer, so every CLI command maps to an endpoint here. servers: - url: https://www.dench.com/api/v1 security: [] tags: - name: agent-config description: Agent Config operations. - name: approvals description: Approvals operations. - name: apps description: Apps operations. - name: auth description: Auth operations. - name: billing description: Billing operations. - name: browser description: Browser operations. - name: chat description: Chat operations. - name: crm description: Crm operations. - name: email description: Email operations. - name: files description: Files operations. - name: gateway description: Gateway operations. - name: local description: Local operations. - name: memory description: Memory operations. - name: meta description: Meta operations. - name: routines description: Routines operations. - name: workspace description: Workspace operations. paths: /agents: get: tags: - workspace summary: List agents description: List agents visible in the workspace status payload. operationId: workspace_agents responses: '200': description: Successful response content: application/json: schema: type: object properties: workspace: type: object properties: id: type: string name: type: string slug: type: string required: - id - name additionalProperties: false agent: type: object properties: id: type: string name: type: string kind: type: string required: - id - name - kind additionalProperties: false rules: type: array items: type: object properties: id: type: string title: type: string body: type: string scope: type: string enum: - organization - project required: - id - title - body - scope additionalProperties: false activeAgents: type: array items: type: object properties: id: type: string name: type: string kind: type: string lastSeenAt: type: number required: - id - name - kind additionalProperties: false pendingApprovals: type: array items: type: object properties: id: type: string title: type: string reason: type: string kind: type: string risk: type: string enum: - low - medium - high description: Risk level. agentId: type: string createdAt: type: number required: - id - title - reason - risk - createdAt additionalProperties: {} recentArtifacts: type: array items: type: object properties: id: type: string runId: type: string title: type: string type: type: string enum: - note - draft - report - task_suggestion - patch - other status: type: string enum: - draft - approved - rejected - applied - archived content: type: string createdAt: type: number updatedAt: type: number required: - id - runId - title - type - status - content - createdAt - updatedAt additionalProperties: false suggestedWork: type: array items: type: object properties: id: type: string runId: type: string title: type: string type: type: string enum: - note - draft - report - task_suggestion - patch - other status: type: string enum: - draft - approved - rejected - applied - archived content: type: string createdAt: type: number updatedAt: type: number nextCommands: type: array items: type: string required: - id - runId - title - type - status - content - createdAt - updatedAt - nextCommands additionalProperties: false memory: type: array items: type: object properties: id: type: string key: type: string kind: type: string enum: - fact - decision - preference - goal - tool_note - other - convention - project_context - agent_lesson - docs_knowledge - open_goal description: Memory classification. text: type: string tags: type: array items: type: string status: type: string enum: - active - needs_review - archived updatedAt: type: number required: - id - key - kind - text - tags - status - updatedAt additionalProperties: false chatAgents: type: object properties: nextCommands: type: array items: type: string activeRuns: type: array items: type: object properties: id: type: string goal: type: string status: type: string model: type: string createdAt: type: number required: - id - goal - status - model - createdAt additionalProperties: {} templates: type: array items: type: string required: - nextCommands - activeRuns - templates additionalProperties: false tools: type: object properties: discovery: type: array items: type: string cli: type: array items: type: string approvalPolicy: type: string required: - discovery - cli - approvalPolicy additionalProperties: false nextActions: type: array items: type: string required: - workspace - agent - rules - activeAgents - pendingApprovals - recentArtifacts - suggestedWork - memory - chatAgents - tools - nextActions additionalProperties: false description: >- Workspace orientation payload shared by /context, /status, /agents, and /approvals. example: 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 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' security: - DenchApiKey: [] - AgentSession: [] components: responses: BadRequest: description: Invalid request content: application/json: schema: $ref: '#/components/schemas/ApiError' Unauthorized: description: Missing or invalid authentication content: application/json: schema: $ref: '#/components/schemas/ApiError' NotFound: description: Operation or resource not found content: application/json: schema: $ref: '#/components/schemas/ApiError' InternalError: description: Server error content: application/json: schema: $ref: '#/components/schemas/ApiError' schemas: ApiError: type: object required: - error properties: error: type: object required: - message - type - code properties: message: type: string type: type: string code: type: string details: {} securitySchemes: DenchApiKey: type: http scheme: bearer bearerFormat: DENCH_API_KEY description: >- Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes. AgentSession: type: http scheme: bearer bearerFormat: dch_agent_* description: >- Agent session token created by `dench signin`. Gateway-backed routes exchange this token for the workspace gateway key. ````