> ## Documentation Index
> Fetch the complete documentation index at: https://vida.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List a Computer Agent workspace directory

> Lists customer-created files and folders at an optional workspace-relative directory. Omit path to list the ordinary workspace root. Canvas source is intentionally omitted there but can be listed directly with path app. Agent instructions and settings do not appear in customer results; update them through the agent configuration workflow.




## OpenAPI

````yaml post /api/v2/computer/accounts/{targetAccountId}/workspace/list
openapi: 3.0.0
info:
  version: 2.0.0
  title: Vida API
  description: Vida API Documentation
servers:
  - url: https://api.vida.dev
    description: Vida Production
    variables:
      baseUrl:
        default: api.vida.dev
        description: Production API Root
security: []
tags:
  - name: Agents
  - name: Inbound Email
    description: Control which senders may create inbound email work for an Agent.
  - name: Features
    description: Inspect capabilities available within an account hierarchy.
  - name: Conversation Logs
    description: Query conversation activity and calculate account-level metrics.
  - name: Computer Agents
    description: Set up, configure, inspect, and manage Vida Computer Agents.
  - name: Computer Agent Sessions
    description: View and reset Computer Agent sessions.
  - name: Accounts
  - name: Agent Templates
    description: Create, manage, and apply reusable Agent configurations.
paths:
  /api/v2/computer/accounts/{targetAccountId}/workspace/list:
    post:
      tags:
        - Computer Agents
      summary: List a Computer Agent workspace directory
      description: >
        Lists customer-created files and folders at an optional
        workspace-relative directory. Omit path to list the ordinary workspace
        root. Canvas source is intentionally omitted there but can be listed
        directly with path app. Agent instructions and settings do not appear in
        customer results; update them through the agent configuration workflow.
      operationId: workspacePostWorkspaceList
      parameters:
        - name: targetAccountId
          in: path
          required: true
          description: ''
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                path:
                  type: string
                  description: Workspace-relative directory. Omit to list the root.
                limit:
                  type: integer
                  minimum: 1
                  maximum: 2000
                  description: Maximum number of entries to return.
      responses:
        '200':
          description: Workspace directory listing
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  result:
                    type: object
                    required:
                      - entries
                    properties:
                      path:
                        type: string
                      entries:
                        type: array
                        items:
                          type: object
                          required:
                            - path
                            - name
                          properties:
                            path:
                              type: string
                            name:
                              type: string
                            type:
                              type: string
                            isDir:
                              type: boolean
                            size:
                              type: integer
                              nullable: true
                      truncated:
                        type: boolean
                      limit:
                        type: integer
                required:
                  - result
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````