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: GetVoiceBot API
description: GetVoiceBot API Documentation
servers:
- url: https://api.getvoicebot.com
description: GetVoiceBot Production
variables:
baseUrl:
default: api.getvoicebot.com
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 GetVoiceBot 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: GetVoiceBot API Token
````
